Data API's

market movers

Fetch top options, futures, and stocks ranked by open interest, traded volume, or price movement. Select the instrument type(s) and ranking category to retrieve the highest-ranked instruments.

post/data/marketmovers

Headers

access-tokenstring required

Request body

exchangeSegment'NSE_FNO' | 'BSE_FNO' | 'NSE_COMM' | 'MCX_COMM' | 'NSE_EQ' | 'BSE_EQ' required
EnumsDescription
NSE_FNONSE Futures and Options segment.
BSE_FNOBSE Futures and Options segment.
NSE_COMMNSE Commodity Derivatives segment.
MCX_COMMMCX Commodity Derivatives segment.
NSE_EQNSE Equity segment.
BSE_EQBSE Equity segment.
instrumentstring[] required

Instrument types to include in the result. Minimum one value is required. All values must belong to the same group (options, futures, or equity) - they cannot be mixed.

category'HIGHEST_OI' | 'OI_GAINERS' | 'OI_LOSERS' | 'TOP_VOLUME' | 'PRICE_GAINERS' | 'PRICE_LOSERS' required

Ranking category to apply. Supported categories depend on the selected instrument.

CategoryApplicable ToDescription
HIGHEST_OIOptionsOption contracts with the highest current open interest.
OI_GAINERSOptions, FuturesDerivative contracts with the highest positive percentage change in open interest.
OI_LOSERSOptions, FuturesDerivative contracts with the highest decline in open interest by percentage.
TOP_VOLUMEOptions, FuturesDerivative contracts with the highest traded volume during the current session.
PRICE_GAINERSStocksEquity instruments with the highest positive percentage price change.
PRICE_LOSERSStocksEquity instruments with the highest negative percentage price change.
expirystring

Expiry date of the derivative contracts in YYYY-MM-DD format. Required when instrument is an option or future contract. Optional and ignored when instrument is EQUITY.
For eg. "2026-07-28"

universe'ALL' | 'FNO_STOCKS' | 'NIFTY_50' | 'NIFTY_BANK' | 'FINNIFTY' | 'INDIA_VIX' | 'NIFTY_MIDCAP' | 'NIFTY_NEXT_50' | 'NIFTY_SMALLCAP_50' | 'NIFTY_MID_CAP_50' | 'NIFTY_100' | 'NIFTY_200' | 'NIFTY_500' | 'NIFTY_MIDCAP_100' | 'NIFTY_MIDCAP_150' | 'NIFTY_SMALLCAP_100' | 'NIFTY_SMALLCAP_250' | 'NIFTY_MICROCAP_250' | 'NIFTY_AUTO' | 'NIFTY_PRIVATE_BANK' | 'NIFTY_FMCG' | 'NIFTY_ENERGY' | 'NIFTY_INFRA' | 'NIFTY_IT' | 'NIFTY_MEDIA' | 'NIFTY_METAL' | 'NIFTY_MNC' | 'NIFTY_PHARMA' | 'NIFTY_PSU_BANK' | 'NIFTY_REALTY' | 'NIFTY_SERVICE_SECTOR' | 'NIFTY_CUNSUMPTION' | 'GIFT_NIFTY' | 'SENSEX' | 'BSE_100' | 'BSE_200' | 'BSE_500' | 'BSE_150_MIDCAP' | 'BSE_250_SMALLCAP' | 'BSE_250_LARGE_MID' | 'BSE_400_MID_SMALL' | 'BSE_BANKEX' | 'BSE_AUTO' | 'BSE_CAPITAL_GOODS' | 'BSE_CONSUMER_DURABLES' | 'BSE_ENERGY' | 'BSE_FINANCE' | 'BSE_FMCG' | 'BSE_HEALTHCARE' | 'BSE_INDIA_MFG' | 'BSE_INDUSTRIALS' | 'BSE_IPO' | 'BSE_IT' | 'BSE_METALS' | 'BSE_OIL_AND_GAS' | 'BSE_POWER' | 'BSE_PSU' | 'BSE_TELECOM'

Stock universe within which instruments are ranked. Required when instrument is EQUITY; ignored otherwise (its presence or absence has no effect for options/futures).

EnumsDescription
ALLAll supported equity instruments in the selected exchange segment.
FNO_STOCKSEquity instruments whose derivatives are available in the F&O segment.
NIFTY_50Equity constituents of the Nifty 50 index.
NIFTY_BANKEquity constituents of the Nifty Bank index.
FINNIFTYEquity constituents of the Nifty Financial Services (FinNifty) index.
INDIA_VIXEquity constituents of the India VIX index.
NIFTY_MIDCAPEquity constituents of the Nifty Midcap index.
NIFTY_NEXT_50Equity constituents of the Nifty Next 50 index.
NIFTY_SMALLCAP_50Equity constituents of the Nifty Smallcap 50 index.
NIFTY_MID_CAP_50Equity constituents of the Nifty Midcap 50 index.
NIFTY_100Equity constituents of the Nifty 100 index.
NIFTY_200Equity constituents of the Nifty 200 index.
NIFTY_500Equity constituents of the Nifty 500 index.
NIFTY_MIDCAP_100Equity constituents of the Nifty Midcap 100 index.
NIFTY_MIDCAP_150Equity constituents of the Nifty Midcap 150 index.
NIFTY_SMALLCAP_100Equity constituents of the Nifty Smallcap 100 index.
NIFTY_SMALLCAP_250Equity constituents of the Nifty Smallcap 250 index.
NIFTY_MICROCAP_250Equity constituents of the Nifty Microcap 250 index.
NIFTY_AUTOEquity constituents of the Nifty Auto index.
NIFTY_PRIVATE_BANKEquity constituents of the Nifty Private Bank index.
NIFTY_FMCGEquity constituents of the Nifty FMCG index.
NIFTY_ENERGYEquity constituents of the Nifty Energy index.
NIFTY_INFRAEquity constituents of the Nifty Infrastructure index.
NIFTY_ITEquity constituents of the Nifty IT index.
NIFTY_MEDIAEquity constituents of the Nifty Media index.
NIFTY_METALEquity constituents of the Nifty Metal index.
NIFTY_MNCEquity constituents of the Nifty MNC index.
NIFTY_PHARMAEquity constituents of the Nifty Pharma index.
NIFTY_PSU_BANKEquity constituents of the Nifty PSU Bank index.
NIFTY_REALTYEquity constituents of the Nifty Realty index.
NIFTY_SERVICE_SECTOREquity constituents of the Nifty Services Sector index.
NIFTY_CUNSUMPTIONEquity constituents of the Nifty Consumption index.
GIFT_NIFTYEquity constituents of the GIFT Nifty index.
SENSEXEquity constituents of the Sensex index.
BSE_100Equity constituents of the BSE 100 index.
BSE_200Equity constituents of the BSE 200 index.
BSE_500Equity constituents of the BSE 500 index.
BSE_150_MIDCAPEquity constituents of the BSE 150 MidCap index.
BSE_250_SMALLCAPEquity constituents of the BSE 250 SmallCap index.
BSE_250_LARGE_MIDEquity constituents of the BSE 250 Large MidCap index.
BSE_400_MID_SMALLEquity constituents of the BSE 400 MidSmallCap index.
BSE_BANKEXEquity constituents of the BSE Bankex index.
BSE_AUTOEquity constituents of the BSE Auto index.
BSE_CAPITAL_GOODSEquity constituents of the BSE Capital Goods index.
BSE_CONSUMER_DURABLESEquity constituents of the BSE Consumer Durables index.
BSE_ENERGYEquity constituents of the BSE Energy index.
BSE_FINANCEEquity constituents of the BSE Finance index.
BSE_FMCGEquity constituents of the BSE FMCG index.
BSE_HEALTHCAREEquity constituents of the BSE Healthcare index.
BSE_INDIA_MFGEquity constituents of the BSE India Manufacturing index.
BSE_INDUSTRIALSEquity constituents of the BSE Industrials index.
BSE_IPOEquity constituents of the BSE IPO index.
BSE_ITEquity constituents of the BSE IT index.
BSE_METALSEquity constituents of the BSE Metal index.
BSE_OIL_AND_GASEquity constituents of the BSE Oil & Gas index.
BSE_POWEREquity constituents of the BSE Power index.
BSE_PSUEquity constituents of the BSE PSU index.
BSE_TELECOMEquity constituents of the BSE Telecom index.
limitinteger required

Maximum number of instruments to return. Allowed range is 1 to 100.
For eg. 20

Example request

{
  "instrument": [
    "OPTIDX",
    "OPTSTK"
  ],
  "expiry": "yyyy-mm-dd"
}

Response

Successful operation

exchangeSegmentstring

Exchange segment for which the instruments were fetched.

categorystring

Ranking category applied to the result.

Changes

No recorded changes to this endpoint across all 1 revision of this API.