Market Holidays

Retrieve the market holidays calendar for the trading year.

GET/3.0/market/holidays

Description

This endpoint returns a comprehensive list of market holidays for the PSX trading calendar. Includes holiday dates, names, and whether the market is closed on those days.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
year	integer	No	Year for which to fetch holidays. If not provided, current year is used	2024

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "date": "2024-02-05",
      "name": "Kashmir Day",
    },
    {
      "date": "2024-03-23",
      "name": "Pakistan Day",
    }
  ]
}

Response Fields

Field	Type	Description
date	string	Holiday date (YYYY-MM-DD)
name	string	Holiday name

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Current Year Holidays

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

Use Cases

• Trading Calendar: Build accurate trading calendar excluding holidays
• Settlement Planning: Plan settlement dates avoiding market holidays
• Schedule Planning: Know when market is closed
• Corporate Actions: Schedule announcements around market holidays
• Operational Planning: Plan market operations and maintenance
• Client Communications: Inform clients of market closures