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을 실제 토큰으로 교체하세요
provider 옵션: US(미국 주식), Taiwan(대만 주식), Binance(암호화폐)
Binance는 market 지정이 필요합니다: Client(현물) 또는 FutureClient(선물)