Holdings
Fetches the entire list of holdings from the portfolio page
🟢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 below table |
🧾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 below table |
| 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 profit and loss of the holding | "-1.10" |
| current_value | 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" |
📑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" |
🔴 Error Response - 400 Bad Request
| Field | Type | Description | Example |
|---|---|---|---|
| status | string | Status of the API call Default Error | "error" |
| code | string | Error code indicating the failure | "e-101" |
| message | string | Specific message explaining the reason for failed request. | "Error Message" |
get
/transactional/v1/portfolio/holdings