TradeVault API · v1

Real-time option chain data,
one HTTP call away.

We expose the same engine that powers TradeVault as a clean REST API. Pull intraday option candles, expiries, strikes, and Greeks straight into your bot, backtester, spreadsheet, or dashboard.

~120ms
p95 latency
99.95%
uptime SLO
1m → 1h
candle intervals
10k / min
rate limit (Pro)
Try it now

One endpoint, all the option data you need.

Hit the URL with your API key and you get back clean OHLC candles for any listed option contract.

GEThttp://localhost:5000/option-chain/chart?symbol=NIFTY&type=CE&expiry=2026-05-19&strike=24200&interval=5&date=2026-05-13
Request
http
GET /option-chain/chart?symbol=NIFTY&type=CE&expiry=2026-05-19&strike=24200&interval=5&date=2026-05-13
Host: localhost:5000
Authorization: Bearer YOUR_API_KEY
Accept: application/json
Response
json
{
  "ok": true,
  "symbol": "NIFTY",
  "type": "CE",
  "expiry": "2026-05-19",
  "strike": 24200,
  "interval": 5,
  "candles": [
    {
      "time": "2026-05-13T08:45:00+00:00",
      "open": 33.35,
      "high": 33.35,
      "low": 33.10,
      "close": 33.10
    },
    {
      "time": "2026-05-13T09:05:00+00:00",
      "open": 31.00,
      "high": 31.00,
      "low": 29.95,
      "close": 30.85
    },
    {
      "time": "2026-05-13T09:10:00+00:00",
      "open": 30.40,
      "high": 30.40,
      "low": 29.90,
      "close": 29.90
    }
  ]
}
Query parameters

Six parameters. Zero guesswork.

NameTypeRequiredExampleDescription
symbolstringrequiredNIFTYUnderlying index or stock symbol.
typestringrequiredCEOption type — CE (Call) or PE (Put).
expirydaterequired2026-05-19Expiry date of the option contract (YYYY-MM-DD).
strikenumberrequired24200Strike price of the option.
intervalnumberrequired5Candle interval in minutes (1, 3, 5, 15, 30, 60).
datedaterequired2026-05-13Trading day to fetch candles for (YYYY-MM-DD).
Response schema

Flat, predictable JSON.

Every successful call returns the same shape. ok: false with a top-level error string on failure.

FieldTypeDescription
okbooleanTrue when the request succeeded. Use this to short-circuit error handling.
symbolstringEchoes the requested symbol — useful when batching.
typestringCE or PE — option type for this contract.
expirydateExpiry date of the returned contract.
strikenumberStrike price of the returned contract.
intervalnumberCandle interval in minutes.
candlesarrayList of OHLC candles, each with time, open, high, low, close.
candles[].timedatetimeISO-8601 UTC timestamp at the start of the candle bucket.
candles[].open / high / low / closenumberOption premium prices for the interval. Always in INR.
Code examples

Drop it into your stack in 30 seconds.

curl
curl -G "http://localhost:5000/option-chain/chart" \
  --data-urlencode "symbol=NIFTY" \
  --data-urlencode "type=CE" \
  --data-urlencode "expiry=2026-05-19" \
  --data-urlencode "strike=24200" \
  --data-urlencode "interval=5" \
  --data-urlencode "date=2026-05-13" \
  -H "Authorization: Bearer YOUR_API_KEY"
Why TradeVault API

Built for traders who actually ship.

Real-time option candles

Stream OHLC candles for every NSE option contract, refreshed each minute during market hours.

Full expiry coverage

Weekly and monthly expiries for indices and F&O stocks — current week, next week, and far-month series.

Granular intervals

1m, 3m, 5m, 15m, 30m and 60m candles. Build your own indicators on top of clean OHLC data.

Historical depth

Backtest with multiple years of intraday option history. Drill into a single contract on a single day.

Predictable JSON

Flat, typed JSON responses. Same shape every time — no surprises, no XML, no field reshuffles.

Fast & affordable

Edge-cached responses, sub-200ms p95 latency. Generous free tier for personal projects.

Authentication

Bearer token in every request.

Generate keys from your dashboard. Send them in the Authorization header. Rotate any time — old keys keep working for 24 hours.

http
Authorization: Bearer tv_live_4f7a9c2e1b8d6a3f0c5b9e4d2a8f1c6b
Rate limits & plans

Pay only when you scale.

  • Free — 60 requests/min · personal projects, paper trading
  • Pro · ₹999/mo — 10,000 requests/min · live algos, dashboards
  • Team · ₹4,999/mo — burst-friendly, multiple keys, priority support
  • Enterprise — dedicated capacity, SLAs, on-prem option
Start free →
Use cases

What people build with it.

01

Live algo trading

Pull intraday option premiums and feed your strategies in real time.

02

Backtesting engines

Replay historical option chains tick by tick with consistent OHLC.

03

Custom dashboards

Build internal tools, Greeks visualizers, and IV analytics on clean data.

04

Research & analytics

Run quant studies across expiries and strikes without scraping NSE.

Ship faster with cleaner option data.

Start free, no credit card. Upgrade when you outgrow the free tier — most users don't for months.