REST / WebSocket 接口

加密货币实时报价

拉取一个或多个加密交易对的最新报价快照，包含最新价、买卖盘与成交量等字段。

更新日期：2026-09-12

GET/api/v1/market/crypto/quote?symbols=BTCUSDT

接口说明

请求参数

字段	类型	必填	说明
`symbols \| symbol`	string	是	CSV 交易对，1–100 个，如 BTCUSDT,ETHUSDT

响应外壳与鉴权

字段	类型	说明
`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[]	报价对象数组
`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/crypto/quote?symbols=BTCUSDT \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

url = "https://api.tiqex.io/api/v1/market/crypto/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/crypto/quote?symbols=BTCUSDT", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
if (!res.ok) throw new Error(res.status);
console.log(await res.json());

返回开发者文档获取 API 密钥