Overview
Binance USDT-M futures quotes (/futures, crypto scope)
Path /api/v1/market/futures/quote — requires crypto market access.
REST / WebSocket endpoints
Binance USDT-M futures quotes
Fetch latest quote snapshots for Binance USDT-margined contracts.
Updated: 2026-09-12
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
symbols | symbol | string | Yes | Binance USDT-M futures, CSV, 1–50 |
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 |
|---|---|---|
(array) | TickerQuote[] | Same shape as crypto quote |
symbol | string | Symbol code |
last | number | Last price |
change | number | Price change |
changePercent | number | Percent change |
open | number | Open |
high | number | High |
low | number | Low |
prevClose | number | Previous close |
volume | number | Volume |
quoteVolume | number | Quote volume |
bid | number | Best bid |
bidSize | number | Best bid size |
ask | number | Best ask |
askSize | number | Best ask size |
openTime / closeTime | number | Window open/close time |
trades | number | Trade count |
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/futures/quote?symbols=BTCUSDT \
-H "X-API-Key: YOUR_API_KEY"Python
import requests
url = "https://api.tiqex.io/api/v1/market/futures/quote?symbols=BTCUSDT"
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/futures/quote?symbols=BTCUSDT", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
if (!res.ok) throw new Error(res.status);
console.log(await res.json());