API連携
リアルタイム相場を自分のプログラムで受け取る
一般のユーザーにはこのページは不要です。注文・戦略・通知はすべてサイト上で完結します。このページは、自分でプログラムを書いて WebSocket で暗号資産のリアルタイム相場を受け取りたい方向けです。
接続には WsToken が必要です。登録後、「アカウントと設定」の概要タブで確認できます。Tokenを取得
接続
下記のURLに WebSocket で接続します。wsToken の部分はご自身のトークンに置き換えてください。
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, subscriptionListsymbol銘柄
BTCUSDT, ETHUSDTproviderデータソース：Binance
BinancemarketBinance のみ：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' } }));注意事項
同時に購読できる銘柄の数は、ご利用のプランによって異なります。プランの詳細を見る