Index Returns

Retrieve performance returns for market indices across various time periods.

GET/3.0/market/indices/stats

Description

This endpoint returns detailed return statistics for market indices including PSX 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": "2025-10-06 10:59:46",
          "name": "ACI",
          "type": 1,
          "c1w": 25562.2647,
          "c1m": 23671.0482,
          "c3m": 20358.0446,
          "c6m": 18715.3702,
          "c1y": 12357.7133,
          "cytd": 18289.7553,
          "c5y": 10270.12
      },
      {
          "date": "2025-10-06 10:59:46",
          "name": "BKTI",
          "type": 1,
          "c1w": 43218.9768,
          "c1m": 41648.0694,
          "c3m": 35828.2461,
          "c6m": 27899.058,
          "c1y": 21052.3972,
          "cytd": 25849.1765,
          "c5y": 13430.1359
      },
  ]
}

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	1-week return value
c1m	number	1-month return value
c3m	number	3-month return value
c6m	number	6-month return value
c1y	number	1-year return value
cytd	number	Year-to-date return value
c5y	number	5-year return value

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