Full Market Quotes

API to retrieve the full market quotes for one or more instruments. Provides the complete market data snapshot of up to 500 instruments in one go. These snapshots are obtained directly from the exchanges at the time of request.

Header Parameters

Name	Required	Type	Description
Authorization	true	string	Requires the format `Bearer access_token` where `access_token` is obtained from the Token API.
Accept	true	string	Defines the content format the client expects, which should be set to `application/json`.

Query Parameters

Name	Required	Type	Description
instrument_key	true	string	Comma separated list of instrument keys. For the regex pattern applicable to this field, see the Field Pattern Appendix.

Notice of Deprecation

The parameter (symbol) is deprecated and will be removed in future versions. We've renamed it (instrument_key) for a more meaningful and significant name.

Responses

Response Body

{
  "status": "success",
  "data": {
    "NSE_EQ:NHPC": {
      "ohlc": {
        "open": 53.4,
        "high": 53.8,
        "low": 51.75,
        "close": 52.05
      },
      "depth": {
        "buy": [
          {
            "quantity": 6917,
            "price": 52.05,
            "orders": 20
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          }
        ],
        "sell": [
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          },
          {
            "quantity": 0,
            "price": 0,
            "orders": 0
          }
        ]
      },
      "timestamp": "2023-10-19T05:21:51.099+05:30",
      "instrument_token": "NSE_EQ|INE848E01016",
      "symbol": "NHPC",
      "last_price": 52.04999923706055,
      "volume": 24123697,
      "average_price": 52.56,
      "oi": 0,
      "net_change": -1.0500000000000043,
      "total_buy_quantity": 6917,
      "total_sell_quantity": 0,
      "lower_circuit_limit": 42.5,
      "upper_circuit_limit": 63.7,
      "last_trade_time": "1697624972130",
      "oi_day_high": 0,
      "oi_day_low": 0
    }
  }
}

Name	Type	Description
status	string	A string indicating the outcome of the request. Typically `success` for successful operations.
data	object	Data object holding full market quote information
data.ohlc	object	Data object with OHLC information
data.ohlc.open	number	The open price of the trading session
data.ohlc.high	number	The high price of the trading session
data.ohlc.low	number	The low price of the trading session
data.ohlc.close	number	The most recent closing price of the symbol
data.depth	object	Data object with top 5 buy and sell depth information
data.depth.buy	object[]	Bids
data.depth.buy[].quantity	integer	quantity
data.depth.buy[].price	number	price
data.depth.buy[].orders	integer	orders
data.depth.sell	object[]	Asks
data.depth.sell[].quantity	integer	quantity
data.depth.sell[].price	number	price
data.depth.sell[].orders	integer	orders
data.timestamp	string	Time in milliseconds at which the feeds was updated
data.instrument_token	string	Key of the instrument. For the regex pattern applicable to this field, see the Field Pattern Appendix.
data.symbol	string	Shows the trading symbol of the instrument
data.last_price	number	The last traded price of symbol
data.volume	integer	The volume traded today on symbol
data.average_price	number	Average price
data.oi	number	Total number of outstanding contracts held by market participants exchange-wide (only F&O)
data.net_change	number	The absolute change from yesterday's close to last traded price
data.total_buy_quantity	number	The total number of bid quantity available for trading
data.total_sell_quantity	number	The total number of ask quantity available for trading
data.lower_circuit_limit	number	The lower circuit of symbol
data.upper_circuit_limit	number	The upper circuit of symbol
data.last_trade_time	string	Time in milliseconds at which last trade happened
data.oi_day_high	number	Open interest day high
data.oi_day_low	number	Open interest day low

Error codes

Error code	Description
UDAPI1087	One of either symbol or instrument_key is invalid - The provided symbol or instrument_key does not confirm to the accepted format.
UDAPI100042	Data of only 500 instrument keys can be requested in single API call - Limit your request to 500 instrument keys at a time.

Examples

A comprehensive set of examples is provided to illustrate various use cases and implementation scenarios for this API. To view detailed examples and access sample code, please refer to: API Examples.