Holdings

This API fetches the complete list of long-term equity holdings for the authenticated user, grouped by ISIN. It includes the current market value, invested value, P&L, and quantity breakdown across DP, Pool, and T+1 buckets.

🔑Header Parameters

🔑 Header Parameters

Header	Type	Required	Description	Example
Content-Type	string	Yes	Specifies the media type of the request	application/json
Authorization	string	Yes	Bearer token for authenticated requests	{{access_token}}
x-api-key	string	Yes	API key used to authorize the request	{{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

Note on security_info: Each holding is identified by ISIN and may be listed on multiple exchanges (e.g., both NSE_EQ and BSE_EQ). The security_info array contains one entry per exchange listing for that ISIN, each with its own exchange segment and scrip token. Use the appropriate entry based on the exchange you intend to trade on.

Field	Type	Description	Example
isin	string	ISIN code of the scrip	INE002A01018
security_info	array 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 scrip	"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	integer	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	string	Unique token/ID assigned to the scrip by the exchange	"1333", "500180"
symbol	string	Trading symbol of the scrip as per the exchange's scrip master file	"HDFCBANK"