API 串接

自己寫程式接收即時行情

一般使用者不需要這頁——下單、策略、通知都能直接在網站上完成。這頁是給想自己寫程式、透過 WebSocket 接收加密貨幣即時行情的人。

連線需要 WsToken：註冊帳號後，可在帳號與設定的總覽頁取得。前往取得

連線方式

用以下網址建立 WebSocket 連線，把 wsToken 換成你自己的 Token。

URL

wss://api.zzztech.com.tw/ws/v1/symbol/quote?wsToken=**********

訂閱行情

連線成功後，送出以下 JSON 格式來訂閱或取消訂閱標的。

Request

{
  "event": "subscribe",
  "data": {
    "symbol": "BTCUSDT",
    "provider": "Binance",
    "market": "Client"
  }
}

event事件名稱subscribe, unSubscribe, subscriptionList

symbol標的代號BTCUSDT, ETHUSDT

provider資料來源：BinanceBinance

market僅 Binance 需要：Client（現貨）或 FutureClient（合約）Client, FutureClient

可用的事件：

subscribe訂閱行情

unSubscribe取消訂閱

subscriptionList查詢目前的訂閱清單（不需帶 data）

收到的資料格式

訂閱成功後，每筆即時成交都會以以下格式推送。

Response

{
  "m": "Client",
  "s": "BTCUSDT",
  "t": 1683259711641,
  "p": "64250.5",
  "v": "0.012"
}

m市場（可選）

s標的代號

t時間戳記（毫秒）

p成交價格

v成交量

程式範例

以下是可直接執行的完整範例：連線、訂閱現貨與合約行情、印出收到的資料。Python 需先安裝 websocket-client 套件。

JavaScript

Python

JavaScript

const socket = new WebSocket('wss://api.zzztech.com.tw/ws/v1/symbol/quote?wsToken=**********');

socket.addEventListener('open', () => {
  // 訂閱比特幣現貨 / 以太幣合約
  socket.send(JSON.stringify({
    event: 'subscribe',
    data: { symbol: 'BTCUSDT', provider: 'Binance', market: 'Client' },
  }));
  socket.send(JSON.stringify({
    event: 'subscribe',
    data: { symbol: 'ETHUSDT', provider: 'Binance', market: 'FutureClient' },
  }));

  // 查詢目前訂閱清單
  socket.send(JSON.stringify({ event: 'subscriptionList' }));
});

socket.addEventListener('message', (event) => {
  console.log('Received:', JSON.parse(event.data));
});

// 不再需要時取消訂閱
// socket.send(JSON.stringify({ event: 'unSubscribe', data: { symbol: 'BTCUSDT', provider: 'Binance' } }));

注意事項

可同時訂閱的標的數量依你的方案而定。查看方案詳情

開始使用

自動策略

交易與通知

帳戶與方案

進階