Single Index Overview

Retrieve detailed information for a single market index including current value, constituent stocks, valuation metrics, and performance data.

GET/3.0/market/index

Description

This endpoint provides comprehensive data for a specific market index including current price, trading volume, market capitalization, P/E ratio, dividend yield, and constituent stock information. It's ideal for focused analysis of a particular index.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
code	string	Yes	Index code/symbol	KSE100

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data":     {
        "type": 1,
        "date": "2025-10-07 10:42:31",
        "name": "BKTi",
        "code": "BKTI",
        "open": 47318.8643,
        "high": 47549.8072,
        "low": 46822.6112,
        "close": 46983.8899,
        "volume": 58410223,
        "value": 3129090491.06,
        "ldci": 47083.9094,
        "ldcv": 163582679,
        "change": -100.02,
        "change_percent": -0.0021,
        "high52": 47975.5523,
        "low52": 21003.0733,
        "total_scrips": 8,
        "pe_ratio": 6.34,
        "dividend_yield": 0.0793,
        "market_cap": 1279702926640.9
    }
}

Response Fields

Field	Type	Description
type	integer	Index type (1 - Exchange, 2 - Non-Tradeable)
date	string	Data timestamp (YYYY-MM-DD HH:MM:SS)
name	string	Index name
code	string	Index code/symbol
open	number	Opening value
high	number	Highest value of the day
low	number	Lowest value of the day
close	number	Closing value
volume	number	Total volume traded
value	number	Total value traded (in PKR)
ldci	number	Last day closing index
ldcv	number	Last day closing volume
change	number	Points change
change_percent	number	Percentage change
high52	number	52-week high
low52	number	52-week low
total_scrips	integer	Number of constituent scrips
pe_ratio	number	Price-to-Earnings ratio of the index
dividend_yield	number	Dividend yield of the index (%)
market_cap	number	Total market capitalization (in PKR)

Constituent Fields

Field	Type	Description
symbol	string	Stock symbol
weight	number	Weight percentage in the index
price	number	Current stock price
change	number	Absolute price change
change_percent	number	Percentage price change

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameters (200)

{
  "status": "error",
  "message": "index_code_required"
}

Not Found (200)

{
  "status": "error",
  "message": "not_found"
}

Examples

Get Single Index Overview

curl -X GET "https://csapis.com/3.0/market/index?code=KSE100" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Index Analysis: Get detailed information about a specific index
• Constituent Analysis: Review which stocks make up an index and their weights
• Performance Tracking: Monitor index performance and movements
• Portfolio Benchmarking: Compare portfolio against a specific index benchmark
• Sector Exposure: Understand exposure to specific sectors through indices
• Risk Analysis: Analyze index composition and diversification