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, their weights in the portfolio, sector allocation, and composition analysis. 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": "UBLPETF",
"name": "UBL Pakistan ETF",
"shares": 250000,
"cash_component": 5000000,
"update_date": "2024-08-15",
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
symbol | string | ETF symbol |
name | string | ETF name |
cash_component | number | Cash held in the fund in PKR |
shares | integer | Total number of ETF shares outstanding |
update_date | string | Date of basket update (YYYY-MM-DD) |
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