Get Trades

This API allows you to fetch all the trades executed in your account today.

USE CASE

Check the price and quantity at which your orders were filled today.

Note

Live Streaming — Receive trade execution updates in real time through the General WebSocket. View General WebSocket Overview documentation.

Details

Fetches all the trades for the current day across all platforms and exchanges in the current trading day.
Each row is one executed trade. orderNumber links it to the order it filled and tradeNumber is the number generated by the exchange.
Orders that were never executed (pending, rejected or cancelled) do not appear here. Use Get Orders to see them.
orderDateTime is the time the trade occurred, in IST. row is a unique value you can use to sort trades.
orderTag carries a 1: prefix for tags you set and 2: for tags generated by FYERS. Trades without a tag show 1:Untagged.
exchangeOrderNo is the order number provided by the exchange, and fyToken is the unique identifier of the symbol.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Response Attributes - For each trade

Attribute	Data Type	Description
`symbol`	string	Eg: NSE:SBIN-EQ
`row`	int	The unique value to sort the trades
`orderDateTime`	string	The time when the trade occurred in “DD-MM-YYYY hh:mm:ss” format in IST
`orderNumber`	string	The order id for which the trade occurred
`tradeNumber`	string	The trade number generated by the exchange
`tradePrice`	float	The traded price
`tradeValue`	float	The total traded value
`tradedQty`	int	The total traded qty
`side`	int	1 => Buy -1 => Sell View Details
`productType`	string	The product in which the order was placed View Details
`exchangeOrderNo`	string	The order number provided by the exchange
`segment`	int	The segment in which order is placed View Details
`exchange`	int	The exchange in which order is placed View Details
`fyToken`	string	Fytoken is a unique identifier for every symbol.
`orderTag`	string	ordertag provided when placing the order Note: `1:` will be concatenated at the start of tag provided by user. `2:` will be concatenated at the start of tag generated internally by Fyers. Default value if tag not provided when order is placed is `1:Untagged`

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

{
  "s": "ok",
  "code": 200,
  "message": "",
  "tradeBook":
              [{
                "clientId":"FXXXXX",
                "orderDateTime":"07-Aug-2020 13:51:12",
                "orderNumber":"120080789075",
                "exchangeOrderNo": "1200000009204725",
                "exchange":10,
                "side":1,
                "segment":10,
                "orderType":2,
                "fyToken":"101000000010666",
                "productType":"CNC",
                "tradedQty":10,
                "tradePrice":32.7,
                "tradeValue":327.0,
                "tradeNumber":"52605023",
                "row":52605023,
                "symbol":"NSE:PNB-EQ"
                "orderTag": "1:Ordertag"
              },
              {
                "clientId":"FXXXXX",
                "orderDateTime":"07-Aug-2020 13:48:12",
                "orderNumber":"120080789139",
                "exchangeOrderNo": "1000000012031528",
                "exchange":10,
                "side":1,
                "segment":10,
                "orderType":2,
                "fyToken":"101000000010454",
                "productType":"CNC",
                "tradedQty":19,
                "tradePrice":14.1,
                "tradeValue":267.9,
                "tradeNumber":"3281523",
                "row":3281523,
                "symbol":"NSE:CENTRUM-EQ"
                "orderTag": "1:Ordertag"
              },
              {
                "clientId":"FXXXXX1",
                "orderDateTime":"07-Aug-2020 13:47:22",
                "orderNumber":"120080797993",
                "exchangeOrderNo": "1100000008047027",
                "exchange":10,
                "side":1,
                "segment":10,
                "orderType":2,
                "fyToken":"101000000018783",
                "productType":"CNC",
                "tradedQty":4,
                "tradePrice":115.5,
                "tradeValue":462.0,
                "tradeNumber":"27945307",
                "row":27945307,
                "symbol":"NSE:IDFNIFTYET-EQ"
                "orderTag": "1:Ordertag"
              }]
}

Get Trades

Response Attributes - For each trade

Video learning