티커

티커 데이터 스트림입니다.

연결

websocat

# spot market
websocat wss://api.datamaxiplus.com/ws/v1/ticker/spot -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

# futures market
websocat wss://api.datamaxiplus.com/ws/v1/ticker/futures -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

wscat

# spot market
wscat -c wss://api.datamaxiplus.com/ws/v1/ticker/spot -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

# futures market
wscat -c wss://api.datamaxiplus.com/ws/v1/ticker/futures -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

구독

• method는 요청 유형을 지정합니다.
• params 리스트는 사용자가 구독하려는 거래소의 심볼 목록입니다. 파라미터 형식은 {base}-{quote}@{exchange}@{currency}@{conversionBase}입니다 (예: "BTC-KRW@upbit@USD@USDT").
  • 지원되는 거래소 목록은 /api/v1/ticker/exchanges, 심볼 목록은 /api/v1/ticker/symbols 엔드포인트에서 조회할 수 있습니다.
  • 지원 통화: USD, KRW
  • 지원 변환 기준: USDT, USD
• id는 구독 요청을 고유하게 식별합니다.

schema

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

example

{
  "method": "SUBSCRIBE",
  "params": [
    "BTC-KRW@upbit@USD@USDT"
  ],
  "id": 1
}

응답

필드 (JSON key)	설명
p	MidPrice — 최신 가격. 예시: 43000
v	Volume — 최근 24시간 거래량. 예시: 1000
p24h	Price24hAgo — 24시간 전 가격. 예시: 42000
pc	PriceChange — 최신 가격과 24시간 전 가격 간 변동률. 예시: 0.0238
hb	HighestBid — 오더북의 최고 매수 호가. 예시: 41900
la	LowestAsk — 오더북의 최저 매도 호가. 예시: 42100
ud	BidDepth2p — 오더북의 상단 깊이 (2%). 예시: 1000
ld	AskDepth2p — 오더북의 하단 깊이 (2%). 예시: 1000
e	Exchange — 거래소 이름. 예시: binance
s	Symbol — 심볼 (base-quote). 예시: BTC-USDT
b	Base — 기준 토큰. 예시: BTC
q	Quote — 견적 토큰. 예시: USDT
d	Timestamp — UTC 밀리초 단위 타임스탬프. 예시: 1632960000000
m	Market — 마켓 유형. 예시: spot

schema

{
"p": float,     // Latest price
"v": float,     // Trading volume in the last 24 hours
"p24h": float,  // Price 24 hours ago
"pc": float,    // Price change between latest price and price 24 hours ago
"hb": float,    // Highest bid from orderbook
"la": float,    // Lowest ask from orderbook
"ud": float,    // Upper depth (2%) from orderbook
"ld": float,    // Lower depth (2%) from orderbook
"e": string,    // Exchange name
"s": string,    // Symbol (base-quote)
"b": string,    // Base token
"q": string,    // Quote token
"d": int,       // Timestamp in UTC milliseconds
"m": string     // Market type
}

example

{
"p": 43000,
"v": 1000,
"p24h": 42000,
"pc": 0.0238,
"hb": 41900,
"la": 42100,
"ud": 1000,
"ld": 1000,
"e": "binance",
"s": "BTC-USDT",
"b": "BTC",
"q": "USDT",
"d": 1632960000000,
"m": "spot"
}