Get Positions

This API allows you to fetch your open and closed positions for the current trading day.

USE CASE

Check the net quantity, average price and profit or loss of each position.

Note

Live Streaming — Receive live position updates through the General WebSocket. View General WebSocket Overview documentation.

Previous trading day’s closed positions are not shown here.

Details

Fetches the current open and closed positions for the current trading day. Note that previous trading day’s closed positions will not be shown here.
Open and closed positions of the current trading day are returned in netPositions, and the account totals come in a separate overall object.
id is the position id, for example NSE:SBIN-EQ-INTRADAY (symbol plus product type). Use it with Exit Position by ID, Convert Position and the stop loss APIs.
side shows whether the position is long or short, and qty is the absolute value of netQty.
realized_profit is the profit or loss already booked and pl is the total. cfBuyQty and cfSellQty are carry forward quantities; dayBuyQty and daySellQty are today's.
For cross currency positions use rbiRefRate, and for commodity positions qtyMulti_com, when you calculate P&L yourself.
slNo is deprecated. Do not rely on it to sort positions.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Response Attributes - For each position

Attribute	Data Type	Description
`symbol`	string	Eg: NSE:SBIN-EQ
`id`	string	The unique value for each position
`buyAvg`	float	Average buy price
`buyQty`	int	Total buy qty
`sellAvg`	float	Average sell price
`sellQty`	int	Total sell qty
`netAvg`	float	netAvg
`netQty`	int	Net qty
`side`	int	The side shows whether the position is long / short View Details
`qty`	int	Absolute value of net qty
`productType`	string	The product type of the position View Details
`realized_profit`	float	The realized p&l of the position
`pl`	float	The total p&l of the position
`crossCurrency`	string	Y => It is cross currency position N => It is not a cross currency position
`rbiRefRate`	float	Incase of cross currency position, the rbi reference rate will be required to calculate the p&l
`qtyMulti_com`	float	Incase of commodity positions, this multiplier is required for p&l calculation
`segment`	int	The segment in which the position is taken. View Details
`exchange`	int	The exchange in which the position is taken. View Details
`ltp`	float	LTP is the price from which the next sale of the stocks happens
`fytoken`	string	Fytoken is a unique identifier for every symbol. View Details
`cfBuyQty`	int	Carry forward buy quantity
`cfSellQty`	int	Carry forward sell quantity
`dayBuyQty`	int	Day forward buy quantity
`daySellQty`	int	Day forward sell quantity
`exchange`	int	The exchange in which order is placed View Details
`slNo`	int	---Deprecated--- This is used for sorting of positions

Response Attributes - Overall Positions

Attribute	Data Type	Description
`count_total`	int	Total number of positions present
`count_open`	int	Total number of positions opened
`pl_total`	float	Total profit and losses
`pl_realized`	float	Profit and losses when the owned product is sold
`pl_unrealized`	float	Profit and loses when the product is owned , but is not sold

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.positions()
print(response)

{
    "s": "ok",
    "code": 200,
    "message": "",
    "netPositions":
                [{
                  "netQty":1,
                  "qty":1,
                  "avgPrice":72256.0,
                  "netAvg": 71856.0,
                  "side":1,
                  "productType":"MARGIN",
                  "realized_profit":400.0,
                  "unrealized_profit":461.0,
                  "pl":861.0,
                  "ltp":72717.0,
                  "buyQty":2,
                  "buyAvg":72256.0,
                  "buyVal":144512.0,
                  "sellQty":1,
                  "sellAvg":72656.0,
                  "sellVal":72656.0,
                  "slNo":0,
                  "fyToken":"1120200831217406",
                  "crossCurrency":"N",
                  "rbiRefRate":1.0,
                  "qtyMulti_com":1.0,
                  "segment":20,
                  "symbol":"MCX:SILVERMIC20AUGFUT",
                  "id":"MCX:SILVERMIC20AUGFUT-MARGIN",
                  "cfBuyQty": 0,
                  "cfSellQty": 0,
                  "dayBuyQty": 0,
                  "daySellQty": 1,
                  "exchange": 10,
                }],
     "overall":
                {
                  "count_total":1,
                  "count_open":1,
                  "pl_total":861.0,
                  "pl_realized":400.0,
                  "pl_unrealized":461.0
                }            
  }

Get Positions

Response Attributes - For each position

Response Attributes - Overall Positions

Video learning