오픈 인터레스트

실시간 선물 오픈 인터레스트(OI) 스트림입니다. 원하는 {symbol}@{exchange} 페어를 구독하면 콜렉터가 관찰한 모든 업데이트를 전달받을 수 있습니다. 선물 전용입니다 (현물 오픈 인터레스트는 존재하지 않습니다).

연결

websocat wss://api.datamaxiplus.com/ws/v1/open-interest -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

wscat -c wss://api.datamaxiplus.com/ws/v1/open-interest -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

params는 {symbol}@{exchange} 항목의 리스트입니다. symbol은 거래소 네이티브 API 심볼(예: Bybit의 BTC-USDT)입니다. 유효하지 않은 페어는 조용히 제거되며, ack에는 검증을 통과한 항목만 반환됩니다.

{ "method": "SUBSCRIBE", "params": [ string ], "id": int32 }

{
  "method": "SUBSCRIBE",
  "params": ["BTC-USDT@bybit", "ETH-USDT@okx"],
  "id": 1
}

각 업데이트는 하나의 페어에 대한 오픈 인터레스트 스냅샷입니다. protojson 인코딩 — 키는 protobuf 스키마의 짧은 JSON 이름을 사용합니다.

필드	설명
`id`	TokenId — 내부 통합 토큰 id
`e`	Exchange — 예: `bybit`
`d`	Timestamp — 거래소 보고 시각 (ms, UTC)
`s`	Symbol — 거래소 네이티브 API 심볼
`b`	Base — 예: `BTC`
`q`	Quote — 예: `USDT`
`oi`	OpenInterest — 기준 자산 단위 오픈 인터레스트
`oiusd`	OpenInterestUsd — USD 환산 오픈 인터레스트 (가격 부재 시 생략)

{
  "id": "bitcoin",
  "e": "bybit",
  "d": 1776826789123,
  "s": "BTC-USDT",
  "b": "BTC",
  "q": "USDT",
  "oi": 98432.5,
  "oiusd": 7500123456.7
}

연결 유지를 위해 주기적으로 {"method":"PING"}을 전송합니다.

각 구독 요청은 params 안의 페어 수와 무관하게 1 credit이 과금됩니다. 연결 자체는 무료입니다.