Holdings

This API allows you to fetch the equity and mutual fund holdings in your demat account.

USE CASE

Show a portfolio view with quantity, cost price, market value and profit or loss for each holding.

Details

Fetches the equity and mutual fund holdings which the user has in this demat account. This will include T1 and demat holdings.
Your app needs the Transactions Info permission. Holdings is part of that template, along with Orders, Positions, Trades, Funds and Market Status.
The request takes no parameters. The holdings list returns equity and mutual fund holdings, including T1 holdings and holdings already in demat.
holdingType tells the kind of holding. See Holding Types for the values.
quantity is the quantity at the start of the day. remainingQuantity is that quantity minus what was sold during the day. qty_t1 is the T+1 quantity.
collateralQuantity is the pledged quantity and remainingPledgeQuantity is the pledged quantity still remaining.
The overall object gives count_total, total_investment, total_current_value, total_pl and pnl_perc for the whole portfolio.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes - For each holding

Attribute	Data Type	Description
`symbol`	string	Eg: NSE:RCOM-EQ
`holdingType`	string	Identify the type of holding View Details
`quantity`	int	The quantity of the symbol which the user has at the beginning of the day
`remainingQuantity`	int	This reflects the quantity - the quantity sold during the day
`pl`	float	Profit and loss made
`costPrice`	float	The original buy price of the holding
`marketVal`	float	The Market value of the current holding
`ltp`	float	LTP is the price from which the next sale of the stocks happens
`id`	int	The unique value for each holding
`fytoken`	string	Fytoken is a unique identifier for every symbol. View Details
`exchange`	int	The exchange in which order is placed. View Details
`segment`	int	The segment in which the holding is taken. View Details
`isin`	string	Unique ISIN provided by exchange for each symbol
`qty_t1`	int	Quantity t+1 day
`remainingPledgeQuantity`	int	Remaining Pledged quantity
`collateralQuantity`	int	Pledged quantity

Response Attributes - Overall holdings

Attribute	Data Type	Description
`count_total`	int	Total number of holdings present
`total_investment`	float	Invested amount for the current holdings
`total_current_value`	float	The present value of the holdings
`total_pl`	float	Total profit and loss made
`pnl_perc`	float	Percentage value of the total pnl

Request

from fyers_apiv3 import fyersModel

client_id = "XC4XXXXM-100"
access_token = "eyJ0eXXXXXXXX2c5-Y3RgS8wR14g"

# Initialize the FyersModel instance with your client_id, access_token, and enable async mode
fyers = fyersModel.FyersModel(client_id=client_id, token=access_token,is_async=False, log_path="")

response = fyers.holdings()
print(response)

{
    "code":200,
    "message":"",
    "s":"ok",
    "overall":{
        "count_total":1,
        "pnl_perc":21.9136,
        "total_current_value":23.700000000000003,
        "total_investment":19.44,
        "total_pl":4.26
    },
    "holdings":[
        {
          "costPrice":6.48,
          "id":0,
          "fyToken":"101000000014366",
          "symbol":"NSE:IDEA-EQ",
          "isin":"INE669E01016",
          "quantity":3,
          "exchange":10,
          "segment":10,
          "qty_t1":0,
          "remainingQuantity":3,
          "collateralQuantity":0,
          "remainingPledgeQuantity":3,
          "pl":4.26,
          "ltp":7.9,
          "marketVal":23.700000000000003,
          "holdingType":"HLD"
        }
    ]
  }

Holdings

Request Attributes - For each holding

Response Attributes - Overall holdings

Video learning