API 연동
내 코드로 실시간 시세 받기
일반 사용자에게는 이 페이지가 필요 없습니다. 주문, 전략, 알림은 모두 웹사이트에서 바로 할 수 있습니다. 이 페이지는 직접 프로그램을 작성해 WebSocket으로 암호화폐 실시간 시세를 받고 싶은 분을 위한 것입니다.
연결하려면 WsToken이 필요해요. 가입 후 '계정 및 설정'의 '계정 개요' 탭에서 확인할 수 있어요.토큰 받기
연결
아래 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' } }));주의 사항
동시에 구독할 수 있는 종목 수는 요금제에 따라 달라요.요금제 자세히 보기