Live Data

Get Quote

GET https://api.groww.in/v1/live-data/quote

This API provides the complete live data snapshot for an instrument including the latest price, market depth, ohlc, market volumes and much more. If one requires only the latest price data then the Get LTP api should be used. Similarly if one is interested in getting only ohlc then Get OHLC api should be used. Use the segment value FNO for derivatives and CASH for stocks and index.

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/live-data/quote?exchange=NSE&segment=CASH&trading_symbol=NIFTY \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Request schema

Name	Type	Description
exchange ^*	string	Stock exchange
segment ^*	string	Segment of the instrument such as CASH, FNO etc.
trading_symbol ^*	string	Trading Symbol of the instrument as defined by the exchange

^*required parameters

Response

{
  "status": "SUCCESS",
  "payload": {
    "average_price": 150.25,
    "bid_quantity": 1000,
    "bid_price": 150,
    "day_change": -0.5,
    "day_change_perc": -0.33,
    "upper_circuit_limit": 151,
    "lower_circuit_limit": 148.5,
    "ohlc": "{open: 149.50,high: 150.50,low: 148.50,close: 149.50}",
    "depth": {
      "buy": [
        {
          "price": 100.5,
          "quantity": 1000
        }
      ],
      "sell": [
        {
          "price": 100.5,
          "quantity": 1000
        }
      ]
    },
    "high_trade_range": 150.5,
    "implied_volatility": 0.25,
    "last_trade_quantity": 500,
    "last_trade_time": 1633072800000,
    "low_trade_range": 148.25,
    "last_price": 149.5,
    "market_cap": 5000000000,
    "offer_price": 150.5,
    "offer_quantity": 2000,
    "oi_day_change": 100,
    "oi_day_change_percentage": 0.5,
    "open_interest": 2000,
    "previous_open_interest": 1900,
    "total_buy_quantity": 5000,
    "total_sell_quantity": 4000,
    "volume": 10000,
    "week_52_high": 160,
    "week_52_low": 140
  }
}

Response Schema

Name	Type	Description
status	string	SUCCESS if request is processed successfully, FAILURE if the request failed
average_price	decimal	Average price of the instrument in Rupees
bid_quantity	integer	Quantity of the bid
bid_price	decimal	Price of the bid
day_change	decimal	Day change in price
day_change_perc	decimal	Day change percentage
upper_circuit_limit	decimal	High price range
lower_circuit_limit	decimal	Low price range
open	decimal	Opening price
high	decimal	Highest price
low	decimal	Lowest price
close	decimal	Closing price
price	decimal	Price of the book entry
quantity	integer	Quantity of the book entry
high_trade_range	decimal	High trade range
implied_volatility	decimal	Implied volatility
last_trade_quantity	integer	Last trade quantity
last_trade_time	integer	Last trade time in epoch milliseconds
low_trade_range	decimal	Low trade range
last_price	decimal	Last traded price
market_cap	decimal	Market capitalization
offer_price	decimal	Offer price
offer_quantity	integer	Quantity of the offer
oi_day_change	decimal	Open interest day change
oi_day_change_percentage	decimal	Open interest day change percentage
open_interest	decimal	Open interest
previous_open_interest	decimal	Previous open interest
total_buy_quantity	decimal	Total buy quantity
total_sell_quantity	decimal	Total sell quantity
volume	integer	Volume of trades
week_52_high	decimal	52-week high price
week_52_low	decimal	52-week low price

^* All prices in rupees.

Get LTP

GET https://api.groww.in/v1/live-data/ltp

The API can be used to get the latest price of an instrument. Use the segment value FNO for derivatives and CASH for stocks and indices. Upto 50 instruments are supported for each api call.

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/live-data/ltp?segment=CASH&exchange_symbols=NSE_RELIANCE,BSE_SENSEX \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Request schema

Name	Type	Description
segment ^*	string	Segment of the instrument such as CASH, FNO etc.
exchange_symbols ^*	array[string]	String of trading symbols with their respective exchanges. For example `NSE_RELIANCE` `BSE_SENSEX` `NSE_NIFTY25APR24100PE`

^*required parameters

Response

{
  "status": "SUCCESS",
  "payload": {
    "NSE_RELIANCE": 2334.2,
    "BSE_SENSEX": 73243.4
  }
}

Response Schema

Name	Type	Description
status	string	SUCCESS if request is processed successfully, FAILURE if the request failed
ltp	decimal	Last traded price

^* All prices in rupees.

Get OHLC

GET https://api.groww.in/v1/live-data/ohlc

The API can be used to get the ohlc data of an instrument. Use the segment value FNO for derivatives and CASH for stocks and indices. Upto 50 instruments are supported for each API call.

Note: The OHLC data retrieved using the OHLC API reflects the current time's OHLC (i.e., real-time snapshot). For interval-based OHLC data (e.g., 1-minute, 5-minute candles), please refer to the Historical Data API.

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/live-data/ohlc?segment=CASH&exchange_symbols=NSE_RELIANCE,BSE_SENSEX \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Request schema

Name	Type	Description
segment ^*	string	Segment of the instrument such as CASH, FNO etc.
exchange_symbols ^*	array[string]	String of trading symbols with their respective exchanges For example `NSE_RELIANCE` `BSE_SENSEX` `NSE_NIFTY25APR24100PE`

^*required parameters

Response

{
  "status": "SUCCESS",
  "payload": {
    "NSE_RELIANCE": "{open: 149.50,high: 150.50,low: 148.50,close: 149.50}",
    "BSE_SENSEX": "{open: 149.50,high: 150.50,low: 148.50,close: 149.50}"
  }
}

Response Schema

Name	Type	Description
status	string	SUCCESS if request is processed successfully, FAILURE if the request failed
open	decimal	Opening price
high	decimal	Highest price
low	decimal	Lowest price
close	decimal	Closing price

^* All prices in rupees.

On this page