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（合约）