Overview
Continuous futures candles (/tv-futures, futures scope)
Path /api/v1/market/tv-futures/kline with futures entitlement.
REST / WebSocket endpoints
Continuous futures candles
Fetch TV continuous contract candles; requires futures market scope.
Updated: 2026-09-12
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Symbol (required) |
interval | string | No | Default 1; supports 1/1m, 5, 15, 60/1h, 240/4h, 1d, 1w, 1mo, … |
limit | number | No | Default 300, range 1–5000 |
Response envelope & auth
| Field | Type | Description |
|---|---|---|
succ | boolean | Whether the request succeeded |
data | object | array | Business payload (see fields below) |
msg | string | Human-readable error message on failure (optional) |
code | string | Machine-readable error code (optional) |
X-Request-Id | header | Request trace ID (response header, not in JSON body) |
X-API-Key | header | API key; Authorization: Bearer is also accepted |
data payload fields
| Field | Type | Description |
|---|---|---|
symbol | string | Resolved symbol |
interval | string | Normalized interval |
bars | array | Candle array (see below) |
source | string | Always tradingview |
market | string | Market tag for this path |
bars[].openTime / openTimeMs | string | number | Bar open time |
bars[].closeTime / closeTimeMs | string | number | Bar close time |
bars[].open / high / low / close | number | OHLC |
bars[].volume | number | Volume |
Common error codes
| code | HTTP | Description |
|---|---|---|
INVALID_REQUEST | 400 | Missing or invalid parameters (e.g. interval) |
INVALID_SYMBOL | 400 | Invalid symbol format |
UNKNOWN_SYMBOL | 400 | Unrecognized symbol (multi-market quote) |
NO_SUBSCRIPTION | 403 | No active subscription |
SUBSCRIPTION_EXPIRED | 403 | Subscription expired |
MARKET_NOT_ENABLED | 403 | Market not enabled on current plan |
API_KEY_SCOPE_DENIED | 403 | API key scope denied |
IP_DENIED / GEO_DENIED | 403 | IP or geo policy denied |
DAILY_LIMIT_EXCEEDED | 429 | Daily quota exceeded |
MONTHLY_LIMIT_EXCEEDED | 429 | Monthly quota exceeded |
RATE_LIMIT_EXCEEDED | 429 | Per-user RPM exceeded |
KEY_RATE_LIMIT_EXCEEDED | 429 | Per-key RPM exceeded |
UPSTREAM_UNAVAILABLE | 502 | Upstream market source unavailable |
RATE_LIMIT_UNAVAILABLE | 503 | Rate-limit infrastructure unavailable |
WS_CONN_LIMIT | WS | WebSocket connection cap reached |
Rate limits & quotas
- REST quote/kline and WS handshake count toward daily quota and RPM; pushed ticks are not re-counted.
- Typical RPM: Free/Trial 30, Growth/Standard 120, Pro 600, Enterprise 3000 (see console plan).
- WS caps (approx.): Free 1 conn / 10 symbols; Growth 3/25; Pro 10/50; Enterprise 50/200.
Request example (cURL)
curl https://api.tiqex.io/api/v1/market/tv-futures/kline?symbol=ES1!&interval=1h \
-H "X-API-Key: YOUR_API_KEY"Python
import requests
url = "https://api.tiqex.io/api/v1/market/tv-futures/kline?symbol=ES1!&interval=1h"
headers = {"X-API-Key": "YOUR_API_KEY"}
resp = requests.get(url, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())JavaScript
const res = await fetch("https://api.tiqex.io/api/v1/market/tv-futures/kline?symbol=ES1!&interval=1h", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
if (!res.ok) throw new Error(res.status);
console.log(await res.json());