Skip to main content

Index Returns

Retrieve the opening value of market indices across various time periods.

GET/3.0/market/indices/stats

Description​

This endpoint returns the opening value for market indices including KSE 100, KSE All Share Index, and other indices across multiple time periods. Useful for analyzing market performance and benchmarking portfolio returns.

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

This endpoint does not accept any query parameters.

Response​

Success Response (200)​

{
"status": "ok",
"message": "",
"data": [
{
"date": "2026-06-22 12:24:00",
"name": "KMIALLSHR",
"type": 1,
"c1w": 67499.9426,
"c1m": 64767.4099,
"c3m": 60009.4665,
"c6m": 67164.5791,
"c1y": 51412.9612,
"cytd": 67872.7806,
"cfy": 0
},
{
"date": "2026-06-22 12:24:00",
"name": "MZNPI",
"type": 1,
"c1w": 30298.9523,
"c1m": 28996.3916,
"c3m": 27709.8628,
"c6m": 30274.6403,
"c1y": 21636.8164,
"cytd": 30646.7789,
"cfy": 0
}
]
}

Response Fields​

FieldTypeDescription
datestringTimestamp of the data (YYYY-MM-DD HH:MM:SS)
namestringIndex name/code
typeintegerIndex type identifier
c1wnumberOpening value for the 1 week period
c1mnumberOpening value for the 1 month period
c3mnumberOpening value for the 3 month period
c6mnumberOpening value for the 6 month period
c1ynumberOpening value for the 1 year period
cytdnumberOpening value for the year-to-date period
cfynumberOpening value for the fiscal year period

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

Get Returns for All Indices​

curl -X GET "https://csapis.com/3.0/market/indices/stats" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases​

  • Market Analysis: Analyze overall market performance
  • Benchmark Comparison: Compare portfolio returns with market indices
  • Market Trends: Track market direction and momentum
  • Economic Indicators: Use market indices as economic indicators
  • Investment Decisions: Use index performance for asset allocation
  • Performance Attribution: Benchmark portfolio against indices