API 레퍼런스

체결정보 응답 (TRADE)

특정 종목의 체결 정보 모니터링

특정 거래 종목에 체결이 발생한 시점에 체결 정보를 내려줍니다.

Topic

FieldsTypeDescription
quote_currencystring마켓 기준 통화
target_currencystring조회 요청할 종목

Stream Fields

FieldsShort fieldTypeDescription
response_typerstringDATA로 고정
channelcstringTRADE로 고정
datadobject구독 data 정보
- quote_currencyqcstring마켓 기준 통화 (예: KRW)
- target_currencytcstring조회한 종목의 심볼 (예: BTC)
- idistring티커 별 ID 값으로 클수록 최신 티커 정보
- timestamptlong타임스탬프 (millisecond)
- pricepstring체결 가격
- qtyqstring체결 수량
- is_seller_makersmboolean매도자가 maker인지 여부

주문 응답 예시

DEFAULT Format Request

{
  "request_type":"SUBSCRIBE",
  "channel":"TRADE",
  "topic":{
    "quote_currency":"KRW",
    "target_currency":"XRP"
  }
}

DEFAULT Format Response

{
  "response_type":"SUBSCRIBED",
  "channel":"TRADE",
  "data":{
    "quote_currency":"KRW",
    "target_currency":"XRP"
  }
}

DEFAULT Format Stream

{
  "response_type":"DATA",
  "channel":"TRADE",
  "data":{
    "quote_currency":"KRW",
    "target_currency":"XRP",
    "id":"1693560450996001",
    "timestamp":1693560450996,
    "price":"688.3",
    "qty":"5000",
    "is_seller_maker":true
  }
}

SHORT Format Request

{
  "request_type":"SUBSCRIBE",
  "channel":"TRADE",
  "topic":{
    "quote_currency":"KRW",
    "target_currency":"XRP"
  },
  "format":"SHORT"
}

SHORT Format Response

{
  "response_type":"SUBSCRIBED",
  "channel":"TRADE",
  "data":{
    "quote_currency":"KRW",
    "target_currency":"XRP"
  }
}

SHORT Format Stream

{
  "r":"DATA",
  "c":"TRADE",
  "d":{
    "qc":"KRW",
    "tc":"XRP",
    "i":"1693560563084003",
    "t":1693560563084,
    "p":"688.3",
    "q":"290.745",
    "sm":false
  }
}