期货 · 大宗商品 · K 线
期货与大宗商品行情 API
连续期货走 tv-futures/kline，金属、能源、农产品各有专用 K 线端点，快照统一走 /market/quote。所有 K 线都是同一套 OHLCV bars 结构，CTA、宏观看板可以直接复用。
关键参数
- 资产类别
- 连续期货 · 金属 · 能源 · 农产品金属 · 能源 · 农产品
- 批量报价
- 最多 50 个 / 次
- K 线周期
- 1 分钟 – 1 月
- 单次 K 线
- 默认 300，最多 5,000 根
- 行情档位
- 专业版全品类实时标准版：金属实时
- 协议
- REST + WebSocket
- 历史深度
- 因市场与套餐而异以控制台权益为准
参数来自开发者文档与套餐接口；连续合约换月规则与单位以上游为准。
覆盖品类与端点
旧路由 /markets/commodities 可指向本页 #commodities。
| 品类 | K 线端点 | 代码示例 | WS market | 最低套餐 |
|---|---|---|---|---|
| 连续期货 | GET /market/continuous-futures/kline | ES1! | futures | 专业版 |
| 贵金属 | GET /market/metals/kline | XAUUSD | metals | 标准版 |
| 能源 | GET /market/energy/kline | CL1! | energy | 专业版 |
| 农产品 | GET /market/agri/kline | ZC1! | agri | 专业版 |
| 综合商品 | GET /market/commodities/kline | 跨品类统一入口 | commodities | 专业版 |
| 快照 | GET /market/quote | codes=ES1!,XAUUSD | — | 按品类权限 |
所有路径前缀为 https://api.tiqex.io/api/v1，鉴权与限流全站一致。
数据字段
各品类 K 线结构相同；快照字段与多市场 quote 一致。
| 字段 | 类型 | 说明 | 所属 |
|---|---|---|---|
succ | boolean | 是否成功 | 外壳 |
data | object | array | 业务数据，见下方字段 | 外壳 |
msg / code | string | 失败时的可读信息与机器错误码（如 MARKET_NOT_ENABLED） | 外壳 |
X-Request-Id | header | 请求追踪 ID，在响应头中，不在 JSON body | 外壳 |
symbol / interval | string | 解析后的产品、归一化周期 | K 线 |
source / market | string | 数据源标识、市场标签 | K 线 |
bars[].openTime / openTimeMs | string | number | K 线开盘时间（RFC3339 / 毫秒） | K 线 |
bars[].closeTime / closeTimeMs | string | number | K 线收盘时间 | K 线 |
bars[].open / high / low / close | number | OHLC | K 线 |
bars[].volume | number | 成交量 | K 线 |
code / symbol / market / category | string | 代码与市场分类 | 报价 |
last / bid / ask / volume | number | 最新价、买卖价与成交量 | 报价 |
change / changePercent / high / low | number | 涨跌额、涨跌幅与日内高低 | 报价 |
timestampMs | number | 行情时间戳（毫秒） | 报价 |
delayed / unavailable | boolean | 是否为快照回退 / 当前不可用 | 报价 |
请求示例
interval 支持 1m、5、15、1h、4h、1d、1w、1mo；limit 1–5000。连续合约符号中的 ! 在 URL 中建议编码为 %21。
# 标普 500 连续合约，1 小时 K 线
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", // 或 metals / energy / agri / commodities
symbols: ["ES1!"]
}))适用场景
01
期货图表终端
连续合约走势与多周期切换，金银、原油、股指同一套图表组件。
02
CTA 与趋势策略
期货与商品 K 线统一结构，跨资产因子计算直接复用。
03
宏观看板与风险监控
股指作为基准做归因与对冲，能源、金属价格跟踪通胀与供需预期。
常见问题
连续合约的代码怎么写？
连续合约符号因上游而异，例如 ES1!。换月规则、合约规格与单位以上游为准，可在控制台产品列表中查询。
标准版能用哪些品类？
标准版包含贵金属与股指实时行情；连续期货、能源、农产品与综合商品需要专业版。免费版不含贵金属。
大宗用专用端点还是 commodities/kline？
金属、能源、农产品各自的端点按品类筛选更直接；commodities/kline 是跨品类统一入口，字段结构完全相同。
指数点位和交易所官方一致吗？
点位精度与延迟以套餐为准，不保证与任一交易所官方发布完全一致；各指数交易时段请参考交易日历。
接入期货与大宗行情
从连续合约 K 线或贵金属报价开始验证，同一把 Key 覆盖全部品类。