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 密鑰開發者教程