接口说明
Binance U 本位合约报价（/futures，归 crypto 权限）
路径 /api/v1/market/futures/quote，需 crypto 市场权限。
REST / WebSocket 接口
Binance U 本位合约报价
获取 Binance U 本位合约最新报价快照。
更新日期：2026-09-12
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbols | symbol | string | 是 | Binance USDT-M 合约，CSV，1–50 个 |
响应外壳与鉴权
| 字段 | 类型 | 说明 |
|---|---|---|
succ | boolean | 是否成功 |
data | object | array | 业务数据（见下方字段） |
msg | string | 失败时的可读错误信息（可选） |
code | string | 机器可读错误码（可选） |
X-Request-Id | header | 请求追踪 ID（响应头，不在 JSON body） |
X-API-Key | header | API Key；也可用 Authorization: Bearer |
data 业务字段
| 字段 | 类型 | 说明 |
|---|---|---|
(array) | TickerQuote[] | 与加密 quote 同构字段 |
symbol | string | 交易对 / 标的代码 |
last | number | 最新价 |
change | number | 涨跌额 |
changePercent | number | 涨跌幅 |
open | number | 开盘价 |
high | number | 最高价 |
low | number | 最低价 |
prevClose | number | 昨收 |
volume | number | 成交量 |
quoteVolume | number | 成交额 |
bid | number | 买一价 |
bidSize | number | 买一量 |
ask | number | 卖一价 |
askSize | number | 卖一量 |
openTime / closeTime | number | 统计窗口开/收时间 |
trades | number | 成交笔数 |
常见错误码
| code | HTTP | 说明 |
|---|---|---|
INVALID_REQUEST | 400 | 参数缺失或非法（如 interval） |
INVALID_SYMBOL | 400 | 标的代码格式无效 |
UNKNOWN_SYMBOL | 400 | 无法识别的标的（多市场 quote） |
NO_SUBSCRIPTION | 403 | 无有效订阅 |
SUBSCRIPTION_EXPIRED | 403 | 订阅已过期 |
MARKET_NOT_ENABLED | 403 | 当前套餐未开通该市场 |
API_KEY_SCOPE_DENIED | 403 | Key 权限范围不足 |
IP_DENIED / GEO_DENIED | 403 | IP 或地区策略拒绝 |
DAILY_LIMIT_EXCEEDED | 429 | 日请求配额用尽 |
MONTHLY_LIMIT_EXCEEDED | 429 | 月请求配额用尽 |
RATE_LIMIT_EXCEEDED | 429 | 用户级 RPM 超限 |
KEY_RATE_LIMIT_EXCEEDED | 429 | 单 Key RPM 超限 |
UPSTREAM_UNAVAILABLE | 502 | 上游行情源暂时不可用 |
RATE_LIMIT_UNAVAILABLE | 503 | 限流组件不可用 |
WS_CONN_LIMIT | WS | WebSocket 连接数达到套餐上限 |
限流与配额
- REST 的 quote / kline / stream 握手计入日配额与 RPM；推送 tick 不再重复计次。
- 默认 RPM 约：Free/Trial 30、Growth/Standard 120、Pro 600、Enterprise 3000（以控制台套餐为准）。
- WebSocket 连接/标的上限约：Free 1 连接/10 标的；Growth 3/25；Pro 10/50；Enterprise 50/200。
请求示例 (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());