Order History

This API allows you to fetch your past orders for a date range, defaulting to the current financial year.

USE CASE

Look up past orders by symbol, segment, exchange or status, such as every rejected order in a quarter.

Details

Fetches all historical orders within the specified date range. If no range is specified, the system automatically defaults to the current financial year.
Send from_date and to_date as YYYY-MM-DD. Without them the report runs from the start of the current financial year to today.
Results are paged: page_size defaults to 100 and page_no to 1. Increase page_no to read further pages.
status filters only on Executed (1), Cancelled (2) or Rejected (3), with 0 for all. There is no filter for pending orders, so use Get Orders for open orders.
In this report segment_type is 0 all, 1 equity, 2 equity derivatives, 3 currency derivatives and 4 commodity derivatives. It has no mutual fund option, unlike the other reports.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes - For each order

Attribute	Data Type	Description
`symbol`	string	Eg: NSE:SBIN-EQ
`page_size`	string	The number of records to be fetched in one page (default is 100)
`page_no`	string	The page number to fetch (default is 1)
`from_date`	string	The start date for fetching orders in “YYYY-MM-DD” format (default is the start of the current financial year)
`to_date`	string	The end date for fetching orders in “YYYY-MM-DD” format (default is the current date)
`segment_type`	string	0 → Includes all Segments [default] 1 → Includes only Equity 2 → Includes only Equity Derivatives 3 → Includes Currency Derivatives 4 → Includes only Commodity Derivatives
`exchange_type`	string	0 → Includes all Exchanges [default] 1 → Includes only NSE 2 → Includes only BSE 3 → Includes only MCX
`status`	string	0 → All Status [default] 1 → Executed 2 → Cancelled 3 → Rejected

Response Attributes - For each order

Attribute	Data Type	Description
`symbol`	string	Eg: NSE:SBIN-EQ
`clientId`	string	The client id of the fyers user
`id_fyers`	string	Fyers system-generated unique identifier for the order
`exchOrdId`	string	The order number provided by the exchange
`exchange`	int	The exchange in which order is placed View Details
`segment`	int	The segment in which order is placed View Details
`instrument`	int	Exchange instrument type View Details
`description`	string	The description of the symbol
`trade_date_time`	int	The epoch time when the trade occurred
`transaction_type`	string	The type of transaction (BUY/SELL)
`trade_date`	string	The time when the trade occurred in “DD-MM-YYYY hh:mm:ss” format in IST
`product_type`	string	The product in which the order was placed View Details
`status`	string	The status of the trade (E.g., Executed, Rejected, etc.)
`ordertype`	string	The order type (E.g., Market, Limit, etc.)
`qty`	int	The quantity of the trade
`tradedQty`	int	The total traded qty
`traded_price`	float	The traded price
`limit_price`	float	The limit price set for the order
`ord_source`	string	The source from which the order was placed
`rejection_reason`	string	The reason for rejection if the order was rejected
`is_symbol_active`	boolean	Indicates if the symbol is currently active for trading

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="")

  data = {
        "symbol": "NSE:SBIN-EQ",
    }
  response = fyers.orderhistory(data=data)
  print(response)

{
          "s": "ok",
          "data": [
                {
                  "symbol": "NSE:SBIN-EQ",
                  "clientId": "XXXXXX",
                  "id_fyers": "26020100012037",
                  "exchOrdId": "603210324081559",
                  "exchange": 11,
                  "segment": 20,
                  "instrument": 30,
                  "description": "SBI",
                  "trade_date_time": 1769920009000,
                  "trade_date ": "01-02-2026 09:56:49",
                  "transaction_type": "SELL",
                  "product_type": "Overnight",
                  "status": "Executed",
                  "ordertype": "Limit",
                  "qty": 1,
                  "tradedqty": 1,
                  "traded_price": 15013,
                  "limit_price": 15013,
                  "ord_source": "Mobile",
                  "rejection_reason": "",
                  "is_symbol_active": true
                }
          ],
          "message": "Order Book data fetched successfully",
          "code": 200
      }