Quotes

This API allows you to get the latest quotes for one or more symbols in a single request.

USE CASE

Refresh the latest price, change, volume and best bid/ask for your watchlist in one request.

Note

Live Streaming — Stream live quote updates through the Data Socket. View Data Socket - Symbol Update documentation.

Details

The Quotes API retrieves the full market quotes for one or more symbols provided by the user.
Your app needs the Market Data permission. Quotes, Market Depth and Historical Data are part of that permission template.
Send each symbol in EXCHANGE:SYMBOL-SERIES format, for example NSE:SBIN-EQ.
Each symbol comes back as its own entry with n (symbol), s (ok or error) and v (values). Check s for every symbol.
If you call the URL directly, URL-encode symbols with special characters, for example M&M as M%26M. The SDKs do this for you.
Where the Call Auction Session does not apply, imbalance, mkt_imbalance and reference_price return 0, and indicative_price returns the last traded price.
The cmd field is deprecated. Do not rely on it.

Plan limits

Standard plan

Up to 50 symbols per request

Prime plan

Up to 1,000 symbols per request

For rate limits and all other plan details, see Plans & rate limits.

Request Attributes

Attribute	Data Type	Description
`symbols`*	string	Maximum symbol limit is 50. Eg: NSE:SBIN-EQ.

Response Attributes

Attribute	Data Type	Description
`s`	string	ok / error
`ch`	float	Change value
`chp`	float	Percentage of change between the current value and the previous day's market close
`lp`	float	Last traded price
`spread`	float	Difference between lowest asking and highest bidding price
`ask`	float	Asking price for the symbol
`bid`	float	Bidding price for the symbol
`open_price`	float	Price at market opening time
`high_price`	float	Highest price for the day
`low_price`	float	Lowest price for the day
`prev_close_price`	float	Previous closing price
`atp`	float	Average traded price
`imbalance`	int	Order imbalance quantity (total buy quantity minus total sell quantity) during the Call Auction Session. Returns 0 for symbols where CAS is not applicable
`mkt_imbalance`	int	Market order imbalance quantity (market buy quantity minus market sell quantity) during the Call Auction Session. Returns 0 for symbols where CAS is not applicable
`reference_price`	float	Reference price of the symbol for the Call Auction Session. Returns 0 for symbols where CAS is not applicable
`indicative_price`	float	Indicative equilibrium price discovered during the Call Auction Session. For symbols where CAS is not applicable, it returns the last traded price
`volume`	int	Volume traded
`short_name`	string	Short name for the symbol Eg: “SBIN-EQ”
`exchange`	string	Name of the exchange. Eg: “NSE” or “BSE”
`description`	string	Description of the symbol
`original_name`	string	Original name of the symbol name provided by the use
`symbol`	string	Symbol name provided by the user
`fyToken`	string	Unique token for each symbol
`tt`	int	Today’s time
`cmd`	dict	---Deprecated---

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 = {
    "symbols":"NSE:SBIN-EQ,NSE:IDEA-EQ"
}

response = fyers.quotes(data=data)
print(response)

{
    "code":200,
    "d":[
        {
          "n":"NSE:SBIN-EQ",
          "s":"ok",
          "v":{
              "ask":0,
              "bid":590.5,
              "ch":-7.95,
              "chp":-1.33,
              "description":"NSE:SBIN-EQ",
              "exchange":"NSE",
              "fyToken":"10100000003045",
              "high_price":600.85,
              "low_price":585,
              "lp":590.5,
              "open_price":598.7,
              "original_name":"NSE:SBIN-EQ",
              "prev_close_price":598.45,
              "atp": 428.07,
              "imbalance": -2969,
              "mkt_imbalance": 32522,
              "reference_price": 427.25,
              "indicative_price": 426.9,
              "short_name":"SBIN-EQ",
              "spread":-590.5,
              "symbol":"NSE:SBIN-EQ",
              "tt":"1691020800",
              "volume":27774877
          }
        },
        {
          "n":"NSE:IDEA-EQ",
          "s":"ok",
          "v":{
              "ask":7.85,
              "bid":0,
              "ch":-0.05,
              "chp":-0.63,
              "description":"NSE:IDEA-EQ",
              "exchange":"NSE",
              "fyToken":"101000000014366",
              "high_price":8.05,
              "low_price":7.8,
              "lp":7.85,
              "open_price":7.9,
              "original_name":"NSE:IDEA-EQ",
              "prev_close_price":7.9,
              "atp": 7.5,
              "imbalance": -1250400,
              "mkt_imbalance": 0,
              "reference_price": 7.9,
              "indicative_price": 7.85,
              "short_name":"IDEA-EQ",
              "spread":7.85,
              "symbol":"NSE:IDEA-EQ",
              "tt":"1691020800",
              "volume":78116800
          }
        }
    ],
    "message":"",
    "s":"ok"
  }

Quotes

Request Attributes

Response Attributes

Video learning