Skip to main content

Smartlist APIs Launch​

Effective May 29, 2026

Three new Smartlist APIs are now available under the /v2/market path. The new endpoints cover futures contracts, options contracts, and MTF-eligible stocks.

A smartlist is a curated, real-time ranked list of instruments grouped by a specific market signal — such as highest traded value, biggest open interest change, or strongest implied volatility move. Instead of scanning the entire market, you get a focused subset of contracts that are most relevant to a given category at that moment. For more information, see the Community post.

What's New​

  • Get Futures Smartlist — Retrieve a ranked list of futures contracts filtered by asset_type (INDEX, STOCK, COMMODITY) and category. Each entry includes live price data and the category-specific ranking metric. PREMIUM and DISCOUNT categories are available for INDEX and STOCK only.

  • Get Options Smartlist — Retrieve a ranked list of options contracts filtered by asset_type (INDEX, STOCK, COMMODITY) and category. Options support additional categories — IV_GAINERS, IV_LOSERS, UNDER_5000, and UNDER_10000 — for INDEX and STOCK asset types.

  • Get MTF Smartlist — Retrieve a ranked list of MTF-eligible stocks enriched with live LTP data. Each entry shows the actual_price, the effective mtf_price after margin, and the margin_saved — making it straightforward to identify the most capital-efficient MTF opportunities.

All three endpoints support pagination via page_number and page_size (maximum 50 per page) and require a valid OAuth access token.

Accepted Category Values​

Futures (GET /v2/market/smartlist/futures):

asset_typeAccepted category values
INDEX, STOCKTOP_TRADED, MOST_ACTIVE, OI_GAINERS, OI_LOSERS, PRICE_GAINERS, PRICE_LOSERS, PREMIUM, DISCOUNT
COMMODITYTOP_TRADED, MOST_ACTIVE, OI_GAINERS, OI_LOSERS

Options (GET /v2/market/smartlist/options):

asset_typeAccepted category values
INDEX, STOCKTOP_TRADED, MOST_ACTIVE, OI_GAINERS, OI_LOSERS, PRICE_GAINERS, PRICE_LOSERS, IV_GAINERS, IV_LOSERS, UNDER_5000, UNDER_10000
COMMODITYTOP_TRADED, MOST_ACTIVE, OI_GAINERS, OI_LOSERS

The metric_key field in each response indicates which metric was used for ranking:

categorymetric_key (Futures)metric_key (Options)
TOP_TRADEDtotal_traded_valuetotal_traded_value
MOST_ACTIVEvolume_traded_todayvolume_traded_today
OI_GAINERS, OI_LOSERSopen_interestopen_interest
PRICE_GAINERS, PRICE_LOSERSpriceprice
PREMIUMpremium—
DISCOUNTdiscount—
IV_GAINERS, IV_LOSERS—implied_volatility
UNDER_5000, UNDER_10000—buy_margin

How to Get Started​

  1. Obtain an access token via the standard OAuth flow or generate a long-lived Analytics Token from your Developer Apps page.
  2. Choose the endpoint that matches your use case from the list above.
  3. Pass the required query parameters — asset_type and category for futures and options; pagination params only for MTF.
  4. Use the metric_key field in the response to understand which metric drove the ranking.

Resources​