ETF Basket

Retrieve the complete basket of holdings and composition details for an ETF.

GET/3.0/etf/basket

Description

This endpoint returns the detailed holdings basket for an ETF, including all constituent securities and cach balance. Useful for understanding exact ETF composition and rebalancing details.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

This endpoint does not accept any query parameters.

Response

Success Response (200)

{
    "status": "ok",
    "message": "",
    "data": [
        {
            "symbol": "NITGETF",
            "name": "NIT Pakistan Gateway ETF",
            "update_date": "2026-06-29 03:31:59",
            "cash_component": 1568.14,
            "constituents": [
                {
                    "symbol": "LUCK",
                    "shares": 51
                },
                {
                    "symbol": "MARI",
                    "shares": 28
                },
                {
                    "symbol": "MCB",
                    "shares": 48
                },
            ]
        }
    ]
}

Response Fields

Field	Type	Description
symbol	string	ETF symbol
name	string	ETF name
update_date	string	Date and time of the latest basket update
cash_component	number	Cash held in the fund in PKR
constituents	array	List of constituent stocks in the basket. See Constituent Object.

Constituent Object

Field	Type	Description
symbol	string	Stock symbol of the constituent
shares	integer	Number of shares in the basket

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get ETF Basket

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

Use Cases

• Portfolio Rebalancing: Understand exact holdings for rebalancing decisions
• Sector Analysis: Analyze sector exposure in the ETF
• Constituent Analysis: Review individual holding details
• Tracking Verification: Verify index replication accuracy
• Due Diligence: Analyze complete holdings list for investment decision