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

Field	Type	Description
date	string	Timestamp of the data (YYYY-MM-DD HH:MM:SS)
name	string	Index name/code
type	integer	Index type identifier
c1w	number	Opening value for the 1 week period
c1m	number	Opening value for the 1 month period
c3m	number	Opening value for the 3 month period
c6m	number	Opening value for the 6 month period
c1y	number	Opening value for the 1 year period
cytd	number	Opening value for the year-to-date period
cfy	number	Opening 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