JavaScript 範例
WebSocket 串接教學
使用原生 JavaScript WebSocket API 串接即時行情數據的完整範例。
1
建立連線
建立 WebSocket 實例，連接到行情伺服器
ConnectionJavaScript
1
2
3
const socket = new WebSocket(
'wss://api.zzztech.com.tw/ws/v1/symbol/quote?wsToken=**********'
);2
訂閱標的
連線成功後，在 open 事件中發送訂閱請求
SubscribeJavaScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// provider: US (美股), Taiwan (台股), Binance (加密貨幣)
socket.addEventListener('open', function (event) {
// 訂閱美股 AAPL
socket.send(JSON.stringify({
event: 'subscribe',
data: { symbol: 'AAPL', provider: 'US' }
}));
// 訂閱台股 2330
socket.send(JSON.stringify({
event: 'subscribe',
data: { symbol: '2330', provider: 'Taiwan' }
}));
// 訂閱比特幣（現貨）
socket.send(JSON.stringify({
event: 'subscribe',
data: { symbol: 'BTCUSDT', provider: 'Binance', market: 'Client' }
}));
});3
接收數據
監聽 message 事件，接收即時行情數據
ListenJavaScript
1
2
3
4
socket.addEventListener('message', function (event) {
const data = JSON.parse(event.data);
console.log('Received:', data);
});4
取消訂閱
發送取消訂閱請求，停止接收特定標的的行情
UnsubscribeJavaScript
1
2
3
4
socket.send(JSON.stringify({
event: 'unsubscribe',
data: { symbol: 'BTCUSDT', provider: 'Binance' }
}));5
查詢訂閱
查詢當前已訂閱的標的列表
QueryJavaScript
1
2
3
socket.send(JSON.stringify({
event: 'subscriptionList'
}));開發提示
請將 wsToken 替換為您的實際 Token
provider 可選值：US（美股）、Taiwan（台股）、Binance（加密貨幣）
Binance 需指定 market：Client（現貨）或 FutureClient（合約）