Futures & Commodities Market Data API
Continuous futures via tv-futures/kline, metals/energy/agri each with dedicated klines, snapshots on /market/quote. One OHLCV bars shape for CTA and macro boards.
Key specs
- Asset classes
- Continuous futures · Metals · Energy · AgricultureMetals · energy · agri
- Batch quotes
- Up to 50 / request
- Candle intervals
- 1 minute – 1 month
- Bars per request
- Default 300, max 5,000 bars
- Latency tiers
- Pro live across productsGrowth: metals and indices realtime
- Protocol
- REST + WebSocket
- History depth
- Varies by market & planSee console entitlements
Limits from docs and plan APIs; roll rules and units follow upstream.
Products & endpoints
Legacy /markets/indices and /markets/commodities map to #indices and #commodities on this page.
| Product | K-line | Example | WS market | Min. plan |
|---|---|---|---|---|
| Continuous futures | GET /market/continuous-futures/kline | ES1! | futures | Pro |
| Precious metals | GET /market/metals/kline | XAUUSD | metals | Growth |
| Energy | GET /market/energy/kline | CL1! | energy | Pro |
| Agriculture | GET /market/agri/kline | ZC1! | agri | Pro |
| Commodities (bundle) | GET /market/commodities/kline | Cross-product entry | commodities | Pro |
| Snapshot | GET /market/quote | codes=ES1!,XAUUSD | — | By product scope |
All paths are prefixed with https://api.tiqex.io/api/v1; auth and rate limits are shared across the site.
Data fields
K-line shape is shared across products; snapshots match multi-market quote.
| Field | Type | Description | Scope |
|---|---|---|---|
succ | boolean | Success flag | Envelope |
data | object | array | Payload; see fields below | Envelope |
msg / code | string | Human message and machine code (e.g. MARKET_NOT_ENABLED) | Envelope |
X-Request-Id | header | Trace ID in response headers, not JSON body | Envelope |
symbol / interval | string | Resolved symbol, normalized interval | K-line |
source / market | string | Source identifier, market tag | K-line |
bars[].openTime / openTimeMs | string | number | Bar open time (RFC3339 / ms) | K-line |
bars[].closeTime / closeTimeMs | string | number | Bar close time | K-line |
bars[].open / high / low / close | number | OHLC | K-line |
bars[].volume | number | Volume | K-line |
code / symbol / market / category | string | Code and market category | Quote |
last / bid / ask / volume | number | Last, bid/ask, volume | Quote |
change / changePercent / high / low | number | Change, change %, day high/low | Quote |
timestampMs | number | Timestamp (ms) | Quote |
delayed / unavailable | boolean | Snapshot fallback / unavailable | Quote |
Request examples
interval: 1m, 5, 15, 1h, 4h, 1d, 1w, 1mo; limit 1–5000. Encode ! in continuous symbols as %21 in URLs.
# S&P 500 continuous, 1h candles
curl "https://api.tiqex.io/api/v1/market/continuous-futures/kline?symbol=ES1%21&interval=1h&limit=500" \
-H "X-API-Key: $TIQEX_KEY"curl "https://api.tiqex.io/api/v1/market/metals/kline?symbol=XAUUSD&interval=4h" \
-H "X-API-Key: $TIQEX_KEY"const ws = new WebSocket("wss://api.tiqex.io/api/v1/market/stream")
ws.onopen = () => ws.send(JSON.stringify({
action: "subscribe",
market: "futures", // or indices / metals / energy / agri / commodities
symbols: ["ES1!"]
}))Use cases
Futures charting
Continuous curves and interval switching — metals, crude, and indices in one chart kit.
CTA & trend systems
Futures and commodity candles share one shape for cross-asset factor pipelines.
Macro boards & risk
Indices as benchmarks; energy and metals for inflation and supply narratives.
FAQ
How are continuous symbols written?
Symbols vary by upstream (e.g. ES1!). Rolls, specs, and units follow upstream — look them up in the console product list.
What does Growth include?
Growth: metals and indices realtime. Continuous futures, energy, agri and the commodities bundle need Pro. Free does not include metals.
Dedicated klines or commodities/kline?
Metal/energy/agri paths filter by product; commodities/kline is the cross-product entry with the same bar shape.
Do index levels match the exchange?
Precision and latency follow your plan; not guaranteed to match official prints. Check the trading calendar for sessions.
Connect futures, indices & commodities
Start with a continuous kline or metals quote — one key covers every product here.