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' } }));

注意事项

可同时订阅的标的数量依你的方案而定。查看方案详情

开始使用

自动策略

交易与通知

账户与方案

进阶