Holdings
Fetches the entire list of holdings from the portfolio page
🔑Header Parameters
| Header | Type | Description | Example/ENUM |
|---|---|---|---|
| Content-type | string | MIME type of the request | application/json |
| Authorization | string | Bearer token for authentication | Bearer access_token |
| x-api-key | string | API Key to access the endpoint | x-api-key |
🟢Success Response - 200 Ok
| Field | Type | Description | Example |
|---|---|---|---|
| status | string | Indicates the status of the API Call | "success" |
| code | string | Response code of the API Request | "s-101" |
| message | string | Descriptive message | "Holdings fetched Successfully" |
| data | array of objects | List of scrips and holding details | See data structure below |
🧾Data Object Info Fields
| Field | Type | Description | Example |
|---|---|---|---|
| ISIN | string | ISIN code of the scrip | INE002A01018 |
| security_info | arrary of object | Security information (e.g.,scrip metadata) | See Security Info Object Fields below |
| total_free | integer | Total free quantity (DP + Poll + SAR) | 150 |
| dp_free | integer | Free quantity in Demat (DP) | 100 |
| pool_free | integer | Free quantity in pool | 30 |
| t1_quantity | integer | Quantity available on T+1 | 20 |
| average_price | string | Average purchase price of the strip | "102.45" |
| last_price | string | Last trader price | "110.00" |
| pnl | string | Current market value of the holding | "3300.00" |
| inv_value | string | Total invested value | "3225.00" |
| product | string | Product type | "DELIVERY" |
| collateral_quantity | string | Quantity marked as collateral | "50" |
| collateral_value | string | Value of the collateral | "5500.00" |
| close_price | integer | Previous close price | 108 |
| dppledge_collateral_qty | integer | Quantity pledged via DP | 10 |
| poolpledge_collateral_qty | integer | Quantity pledged from Pool | 20 |
📑Security Info Object Fields
| Field | Type | Description | Example |
|---|---|---|---|
| exchange | string | Exchange segments where the scrip is listed | "NSE_EQ" |
| scrip_token | integer | Unique token/ID assigned to the scrip by the exchange | 12345 |
| symbol | string | Trading symbol of the scrip as per the exchange's scrip master file | "HDFCBANK" |
get
/transactional/v1/portfolio/holdings