Skip to main content

Holdings

Fetches the entire list of holdings from the portfolio page

🔑Header Parameters

HeaderTypeDescriptionExample/ENUM
Content-typestringMIME type of the requestapplication/json
AuthorizationstringBearer token for authenticationBearer access_token
x-api-keystringAPI Key to access the endpointx-api-key

🟢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 data structure below

🧾Data Object Info Fields

FieldTypeDescriptionExample
ISINstringISIN code of the scripINE002A01018
security_infoarrary of objectSecurity information (e.g.,scrip metadata)See Security Info Object Fields below
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 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"
close_priceintegerPrevious close price108
dppledge_collateral_qtyintegerQuantity pledged via DP10
poolpledge_collateral_qtyintegerQuantity pledged from Pool20

📑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"
get/transactional/v1/portfolio/holdings