Skip to main content

Holdings

Fetches the entire list of holdings from the portfolio page

🟢Success Response - 200 Ok

FieldTypeDescriptionExample
statusstringIndicates the status of the API Call"success"
codestringResponse code of the API Request"s-101"
messagestringDescriptive message"Holdings fetched Successfully"
dataarray of objectsList of scrips and holding detailsSee below table

🧾Data Object Info Fields

FieldTypeDescriptionExample
ISINstringISIN code of the scripINE002A01018
security_infoarrary of objectSecurity information (e.g.,scrip metadata)See below table
total_freeintegerTotal free quantity (DP + Poll + SAR)150
dp_freeintegerFree quantity in Demat (DP)100
pool_freeintegerFree quantity in pool30
t1_quantityintegerQuantity available on T+120
average_pricestringAverage purchase price of the strip"102.45"
last_pricestringLast trader price"110.00"
pnlstringCurrent profit and loss of the holding"-1.10"
current_valuestringCurrent market value of the holding"3300.00"
inv_valuestringTotal invested value"3225.00"
productstringProduct type"DELIVERY"
collateral_quantitystringQuantity marked as collateral"50"
collateral_valuestringValue of the collateral"5500.00"

📑Security Info Object Fields

FieldTypeDescriptionExample
exchangestringExchange segments where the scrip is listed"NSE_EQ"
scrip_tokenintegerUnique token/ID assigned to the scrip by the exchange12345
symbolstringTrading symbol of the scrip as per the exchange's scrip master file"HDFCBANK"

🔴 Error Response - 400 Bad Request

FieldTypeDescriptionExample
statusstringStatus of the API call Default Error"error"
codestringError code indicating the failure"e-101"
messagestringSpecific message explaining the reason for failed request."Error Message"
get/transactional/v1/portfolio/holdings