Groww LogoGroww API

Live Data

This guide describes how to fetch live data of instruments easily using the SDK.

Get Quote

Fetch a real-time quote for an individual instrument using this get_quote method.

Python SDK Usage

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_token"
 
# Initialize Groww API
groww = GrowwAPI(API_AUTH_TOKEN)
 
quote_response = groww.get_quote(
    exchange=groww.EXCHANGE_NSE,
    segment=groww.SEGMENT_CASH,
    trading_symbol="NIFTY"
)
print(quote_response)

Request Schema

NameTypeDescription
exchange *stringStock exchange
segment *stringSegment of the instrument such as CASH, FNO etc.
trading_symbol *stringTrading Symbol of the instrument as defined by the exchange

*required parameters

Response Payload

All prices in rupees.

{
  "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

NameTypeDescription
average_pricefloatAverage price of the instrument
bid_quantityintQuantity of the bid
bid_pricefloatPrice of the bid
day_changefloatDay change in price
day_change_percfloatDay change percentage
upper_circuit_limitfloatHigh price range
lower_circuit_limitfloatLow price range
openfloatOpening price
highfloatHighest price
lowfloatLowest price
closefloatClosing price
pricefloatPrice of the book entry
quantityintQuantity of the book entry
high_trade_rangefloatHigh trade range
implied_volatilityfloatImplied volatility
last_trade_quantityintLast trade quantity
last_trade_timeintLast trade time in epoch milliseconds
low_trade_rangefloatLow trade range
last_pricefloatLast traded price
market_capfloatMarket capitalization
offer_pricefloatOffer price
offer_quantityintQuantity of the offer
oi_day_changefloatOpen interest day change
oi_day_change_percentagefloatOpen interest day change percentage
open_interestfloatOpen interest
previous_open_interestfloatPrevious open interest
total_buy_quantityfloatTotal buy quantity
total_sell_quantityfloatTotal sell quantity
volumeintVolume of trades
week_52_highfloat52-week high price
week_52_lowfloat52-week low price

Get LTP

Fetch the last traded price for multiple instruments using this get_ltp method.

Upto 50 instruments are supported for each function call.

Python SDK Usage

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_token"
 
# Initialize Groww API
groww = GrowwAPI(API_AUTH_TOKEN)
 
ltp_response = groww.get_ltp(
  segment=groww.SEGMENT_CASH,
  exchange_trading_symbols="NSE_NIFTY"
)
print(ltp_response)
 
# you can pass multiple instruments at once
multiple_ltp_response = groww.get_ltp(
  segment=groww.SEGMENT_CASH,
  exchange_trading_symbols=("NSE_NIFTY", "NSE_RELIANCE")
)
print(multiple_ltp_response)

Request Schema

NameTypeDescription
segment *stringSegment of the instrument such as CASH, FNO etc.
exchange_trading_symbols *Tuple[str]String of trading symbols with their respective exchanges

*required parameters

Response Payload

All prices in rupees.

{
  "NSE_RELIANCE": 2500.5,
  "NSE_NIFTY": 22962.10
}

Response Schema

NameTypeDescription

| ltp|float|Last traded price
|

Get OHLC

Get the OHLC details for list of given instruments quickly using this get_ohlc method. Use the segment value FNO for derivatives and CASH for stocks and index.

Upto 50 instruments are supported for each function call.

Note: The OHLC data retrieved using the OHLC SDK method 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 SDK method.

Python SDK Usage

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_token"
 
# Initialize Groww API
groww = GrowwAPI(API_AUTH_TOKEN)
 
ohlc_response = groww.get_ohlc(
  segment=groww.SEGMENT_CASH,
  exchange_trading_symbols="NSE_NIFTY"
)
print(ohlc_response)
 
# you can pass multiple instruments at once
multiple_ohlc_response = groww.get_ohlc(
  segment=groww.SEGMENT_CASH,
  exchange_trading_symbols=("NSE_NIFTY", "NSE_RELIANCE")
)
print(multiple_ohlc_response)

Request Schema

NameTypeDescription
segment *stringSegment of the instrument such as CASH, FNO etc.
exchange_trading_symbols *Tuple[str]String of trading symbols with their respective exchanges

*required parameters

Response Payload

All prices in rupees.

{
  "NSE_NIFTY": {
    "open": 22516.45,
    "high": 22613.3,
    "low": 22526.4,
    "close": 22547.55
  },
  "NSE_RELIANCE": {
    "open": 1212.8,
    "high": 1215.0,
    "low": 1201.0,
    "close": 1204.0
  }
}

Response Schema

NameTypeDescription
openfloatOpening price
highfloatHighest price
lowfloatLowest price
closefloatClosing price

Get Greeks

Fetch the Greeks data for FNO (Futures and Options) contracts using this get_greeks method.

Greeks are financial measures that help assess the risk and sensitivity of options contracts to various factors like underlying price changes, time decay, volatility, and interest rates. This method is specifically designed for derivatives trading and risk management.

Python SDK Usage

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_token"
 
# Initialize Groww API
groww = GrowwAPI(API_AUTH_TOKEN)
 
greeks_response = groww.get_greeks(
    exchange=groww.EXCHANGE_NSE,
    underlying="NIFTY",
    trading_symbol="NIFTY25O1425100CE",
    expiry="2025-10-14"
)
print(greeks_response)

Request Schema

NameTypeDescription
exchange *stringStock exchange - NSE or BSE
underlying *stringUnderlying symbol for the contract such as NIFTY, BANKNIFTY, RELIANCE etc.
trading_symbol *stringTrading Symbol of the FNO contract as defined by the exchange
expiry *stringExpiry date of the contract in YYYY-MM-DD format

*required parameters

Response Payload

{
  "greeks": {
    "delta": 0.6006,
    "gamma": 0.0014,
    "theta": -8.1073,
    "vega": 13.1433,
    "rho": 2.7333,
    "iv": 8.2383
  }
}

Response Schema

NameTypeDescription
deltafloatDelta measures the rate of change of option price based on every 1 rupee change in the price of underlying.
gammafloatGamma measures the rate of change of delta with respect to underlying asset price. Higher gamma means delta changes more rapidly
thetafloatTheta measures the rate of time decay of option price. Usually negative, indicating option value decreases over time
vegafloatVega measures the rate of change of option price based on every 1% change in implied volatility of the underlying asset
rhofloatRho measures the sensitivity of option price to changes in interest rates
ivfloatImplied Volatility represents the market's expectation of future volatility, expressed as a percentage

Previous

Margin

Next

Historical Data

On this page