TIQEX全球实时行情数据

开发者文档

实时行情 API 开发者文档

清晰的接口说明、可运行示例与主流语言 SDK，帮助你快速完成行情接入与上线。

三步上手

从零到第一条行情

注册、鉴权、订阅，按同样的路径即可完成首个实时数据流。

01

创建 API 密钥

注册后即可在控制台生成密钥，用于 REST 与 WebSocket 请求鉴权。

02

发起首个请求

用 X-API-Key 调用报价接口，或连接流式通道订阅标的。

03

订阅实时推送

通过 WebSocket 接收 tick / candle 推送，驱动交易与分析应用。

鉴权

所有请求均需携带 API 密钥。请妥善保管，勿写入前端公开仓库。

  • Header：X-API-Key: YOUR_API_KEY
  • 可为不同环境创建多把密钥并随时轮换
  • 超限或无效密钥将返回 401 / 429
curl https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT \
  -H "X-API-Key: YOUR_API_KEY"

阅读完整专题：鉴权与 API 密钥

REST API

用于快照报价、K 线、市场元数据与财经新闻查询，适合回测准备与按需拉取。

  • 统一 JSON 响应结构
  • 支持按 symbol / interval / 新闻分类过滤
  • 含分页与速率限制头
GET/api/v1/market/crypto/quote最新报价快照
GET/api/v1/market/crypto/kline历史 K 线
GET/api/v1/market/equity/quote美股报价
GET/api/v1/market/equity/kline美股 K 线
GET/api/v1/market/quote外汇 / 大宗 / A股 / 港股 / 期货 / 指数报价
GET/api/v1/market/cn/klineA股 K 线
GET/api/v1/market/hk/kline港股 K 线
GET/api/v1/market/tv-futures/kline连续期货 K 线（/tv-futures，归 futures 权限）
GET/api/v1/market/indices/kline指数 K 线
GET/api/v1/market/forex/kline外汇 K 线
GET/api/v1/market/metals/kline金属 K 线
GET/api/v1/market/energy/kline能源 K 线
GET/api/v1/market/agri/kline农产品 K 线
GET/api/v1/market/commodities/kline大宗商品 K 线
GET/api/v1/market/futures/quoteBinance U 本位合约报价（/futures，归 crypto 权限）
WSwss://api.tiqex.io/api/v1/market/stream实时行情流

WebSocket 流

毫秒级推送，适合交易终端、看板与策略执行。

  • 发送 subscribe JSON，指定 market 与 symbols
  • 自动心跳与断线重连建议
  • 支持多标的批量订阅
wss://api.tiqex.io/api/v1/market/stream
{ "action": "subscribe", "market": "crypto", "symbols": ["BTCUSDT"] }

市场覆盖

美股、A股、港股、外汇、加密、期货、指数与大宗商品，一套接口统一接入。

  • 美股 / A股 / 港股报价与 K 线
  • 外汇、指数与连续期货
  • 加密以及金属 / 能源 / 农产品
  • REST 快照 + WebSocket 实时推送

阅读完整专题：市场覆盖与交易时间

错误处理

标准化错误体，便于日志与告警接入。

  • JSON：succ / msg / code；追踪看响应头 X-Request-Id
  • 4xx 客户端问题，429 配额/限流，5xx 上游或服务端
  • 429 时请按 Retry-After 退避

阅读完整专题：错误码与限流

官方 SDK

用熟悉的语言快速集成，示例与首页代码窗一致。

JavaScript

浏览器与 Node.js 客户端

Python

数据科学与量化脚本

PHP

Web 与服务端集成

Java

企业服务与后台系统

Go

高并发网关与微服务

// TIQEX — GET /api/v1/market/crypto/quote
const res = await fetch(
  'https://api.tiqex.io/api/v1/market/crypto/quote?symbols=BTCUSDT',
  {
    headers: { 'X-API-Key': 'your_api_key' }
  }
)
const json = await res.json()
console.log(json.data)
已连接数据流—

阅读完整专题：SDK 与多语言示例

开发者文档

开发者常见问题

接入行情 API 时最常遇到的问题与解答。

TIQEX 支持哪些市场与数据类型？

覆盖美股、A股、港股、外汇、加密货币、期货、指数、大宗商品与财经新闻，REST 提供快照与历史 K 线，WebSocket 提供实时推送。

如何鉴权？密钥可以放在前端吗？

所有请求需携带 X-API-Key 请求头。密钥应仅存服务端或密钥管理服务，禁止写入浏览器公开代码。

免费套餐能做什么？何时需要升级？

免费套餐适合学习与集成验证。生产环境需要 WebSocket、更低延迟、更高配额或更多市场时，请升级 Growth/Pro 套餐。

遇到 429 限流如何处理？

读取响应头 Retry-After，按指数退避重试；用 X-Request-Id 排查，并对非实时数据做本地缓存。

错误码在哪里看？

失败响应为 succ=false，并带 msg、code；请求追踪请读响应头 X-Request-Id。配额类常见 DAILY_LIMIT_EXCEEDED / RATE_LIMIT_EXCEEDED。

WebSocket 和 REST 怎么配合？

REST 适合快照与历史 K 线回补，WebSocket 适合实时 tick。同一套 API Key；stream 握手计费一次，推送 tick 不重复计次。

标的代码如何填写？

加密多为 BTCUSDT；美股如 AAPL；多市场 quote 可用产品短码或 TV 符号。具体见各端点参数表与控制台标的列表。

数据延迟与覆盖范围如何理解？

延迟、字段粒度与历史深度因市场与套餐而异，以控制台权益与端点文档为准；不保证与任一交易所原生盘口逐字段一致。

准备开始了吗

打开文档，马上跑通第一条行情。

免费注册即可拿到密钥，按快速开始完成接入。

获取免费 API 密钥开发者教程