WebSocket 실시간 시세 스트리밍 API

WebSocket을 사용하는 이유

• Updates are pushed as prices change, which is more timely than polling REST on a timer and does not use your per-minute request allowance.
• One connection can subscribe to many symbols, and several connections can subscribe to the same symbol without affecting each other.
• The protocol is compatible with iTick, so existing subscription code only needs a new endpoint.

메시지 포맷

// Subscribe / unsubscribe. types: tick, quote, depth, kline@1
{"ac":"subscribe","params":"AAPL$US,700$HK","types":"quote,tick"}
{"ac":"unsubscribe","params":"AAPL$US","types":"quote"}

// Heartbeat
{"ac":"ping","params":"1731688569840"}

// Pushed message
{"code":1,"data":{"s":"BTCUSDT","r":"BA","ld":83988.54,"v":0.00019,"type":"tick"}}

JavaScript 연동 예시

const ws = new WebSocket("wss://api.itick.dev/crypto?token=YOUR_API_KEY");

ws.onopen = () => {
  ws.send(JSON.stringify({ ac: "subscribe", params: "BTCUSDT$BA", types: "quote,tick" }));
  // Send a heartbeat at least every 30 seconds
  setInterval(() => ws.send(JSON.stringify({ ac: "ping", params: String(Date.now()) })), 25000);
};

ws.onmessage = (event) => console.log(event.data);

지원 시장

Connect to wss://api.itick.dev/{market} where market is stock, forex, crypto, indices, future or fund. Available data depends on your plan.

연결 및 구독 한도

Concurrent connections per API key per market and symbols per connection are set by your plan; see pricing. The free plan does not include WebSocket by default.

자주 묻는 질문 (FAQ)