外汇 · 主要货币对
外汇实时行情 API
88 组主要货币对：报价走多市场 /market/quote，K 线走 /market/forex/kline，实时推送订阅 market=forex。字段与股票、商品接口一致，适合 FX 终端、风控与宏观研究。
关键参数
- 货币对
- 88 组首页公布口径
- 批量报价
- 最多 50 个 / 次
- K 线周期
- 1 分钟 – 1 月
- 单次 K 线
- 默认 300，最多 5,000 根
- 行情档位
- 标准版起实时企业版实时
- 协议
- REST + WebSocket
- 历史深度
- 因市场与套餐而异以控制台权益为准
货币对数量为 tiqex.io 首页口径；其余参数来自开发者文档与套餐接口。
覆盖范围与端点
外汇专用 K 线路径，快照与商品共用多市场 quote。
| 项目 | 说明 | 端点 / 示例 |
|---|---|---|
| 货币对 | 88 组主要货币对，如 EURUSD、GBPUSD | GET /market/codes 按 category 筛选 |
| 代码格式 | 6 位字母、无斜杠 | EURUSD · GBPUSD |
| 报价快照 | 一次请求多个货币对 | GET /market/quote?codes=EURUSD,GBPUSD |
| 历史 K 线 | 分钟到月线 OHLCV | GET /market/forex/kline |
| 实时推送 | 握手计费一次，tick 不计次 | WS /market/stream market=forex |
| 央行参考汇率 | 首页营销口径提及；无独立 REST/WS 路径 | — 无公开专用端点，以 quote + forex/kline + stream 为主 |
点差与流动性因上游而异，不保证与任一做市商盘口一致。
数据字段
报价来自多市场 quote，K 线为标准 bars 结构。
| 字段 | 类型 | 说明 | 所属 |
|---|---|---|---|
succ | boolean | 是否成功 | 外壳 |
data | object | array | 业务数据，见下方字段 | 外壳 |
msg / code | string | 失败时的可读信息与机器错误码（如 MARKET_NOT_ENABLED） | 外壳 |
X-Request-Id | header | 请求追踪 ID，在响应头中，不在 JSON body | 外壳 |
code / symbol / market / category | string | 代码与市场分类 | 报价 |
last / bid / ask / volume | number | 最新价、买卖价与成交量 | 报价 |
change / changePercent / high / low | number | 涨跌额、涨跌幅与日内高低 | 报价 |
timestampMs | number | 行情时间戳（毫秒） | 报价 |
delayed / unavailable | boolean | 是否为快照回退 / 当前不可用 | 报价 |
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 线 |
请求示例
K 线参数：symbol 必填；interval 支持 1m、5、15、1h、4h、1d、1w、1mo；limit 1–5000。
curl "https://api.tiqex.io/api/v1/market/quote?codes=EURUSD,GBPUSD,USDJPY" \
-H "X-API-Key: $TIQEX_KEY"import os, requests
r = requests.get(
"https://api.tiqex.io/api/v1/market/forex/kline",
params={"symbol": "EURUSD", "interval": "1h", "limit": 1000},
headers={"X-API-Key": os.environ["TIQEX_KEY"]},
timeout=10,
)const ws = new WebSocket("wss://api.tiqex.io/api/v1/market/stream")
ws.onopen = () => ws.send(JSON.stringify({
action: "subscribe", market: "forex", symbols: ["EURUSD", "GBPUSD"]
}))适用场景
01
FX 交易终端
主要货币对报价、买卖价与日内走势，服务零售与机构终端。
02
做市与风控
报价快照与 WebSocket 推送结合，用于价格发现、敞口盯市与阈值告警。
03
宏观与利差研究
多周期 K 线支撑利差、波动率与相关性分析。
常见问题
免费版可以测试外汇吗？
免费版不含外汇。标准版起提供外汇实时行情，专业版与企业版同样为实时。
报价里的 delayed 字段是什么意思？
delayed=true 表示当前返回的是回退快照（实时报价不可用时用最近一根 K 线收盘价兜底），与套餐档位无关；unavailable=true 表示该产品暂时没有可用报价。
周末或节假日推送会中断吗？
外汇休市期间实时流可能静默，这是正常现象。回测和监控请参考交易日历对齐休市时段。
点差和做市商报价一致吗？
点差与流动性因上游而异，不保证与任一做市商盘口一致，适合展示、研究与风控，不建议直接作为成交价依据。
接入主流外汇行情
先用标准版实时数据完成集成，上线前升级专业版补齐其余市场。