marketdata

거래소 마켓 변동 내역

Ticker, Orderbook, Trade feed 등 마켓의 실시간 공개 데이터를 제공하는 API입니다.
How to use WebSocket API를 참조하십시오.

1. Request

param

type

description

type

string

'subscribe'

channel

string

'marketdata'

market_id

string

구독하고자 하는 마켓 ID

filter

string[]

마켓에서 구독하고자 하는 필터

사용할 수 있는 필터는 아래와 같습니다.
ticker,
recent_trades,
order_books_l0,
order_books_l1,
order_books_l2,
order_books_l3,
order_books_l4

(각 필터에 대한 정보는 아래를 참조하십시오.)

interval

number

마켓데이터가 전송되는 시간 간격
사용할 수 있는 값: 100, 500

// request

{
  "channel": "marketdata",
  "filter": [<FILTER>],
  "interval": <INTERVAL>,
  "market_id": <MARKET_ID>,
  "type": "subscribe"
}

2. Response

param

type

description

channel

string

'marketdata'

lag

number

API 서버의 내부 지연시간

market_id

string

마켓 ID

status

string

"ok": 정상
"unavailable": 데이터를 재구성하는 중입니다. 잠시 후 다시 시도해주십시오.

ticker

TICKER

필터에 'ticker'가 포함될 경우 전달됩니다.
Ticker는 최근 거래로부터 24시간동안의 마켓 변동 정보를 표시합니다.

TICKER:

  • base_volume: 기준 화폐 거래량
  • change: 24시간 가격 변동
  • high: 24시간 최고가
  • last: 최근 거래가
  • low: : 24시간 최저가
  • quote_volume: 상대 화폐 거래량
  • time: 최근 거래 시점

recent_trades

RECENT_TRADE[]

필터에 'recent_trade'가 포함될 경우 전달됩니다.
마켓의 최근 100개 거래를 표시합니다.
배열에는 오래된 거래부터 최근 거래까지 시간 내림차순으로 포함됩니다.

RECENT_TRADE:

  • price: 최종 거래가
  • quantity: 거래 수량
  • time: 거래 시간
  • side: 'buy' 또는 'sell'
  • tick_direction: 이전 거래 대비 최근 거래 체결가 변동 ('up' | 'down' | 'zero' | 'zeroup' | 'zerodown')

order_books
order_books_l1
order_books_l2
order_books_l3
order_books_l4

ORDER_BOOK[]

필터에 'order_books_l0', 'order_books_l1', 'order_books_l2', 'order_books_l3', 'order_books_l4' 중 하나 이상 포함될 경우 각 필터로 전달됩니다.

아래와 같이 오더북의 변동사항을 전달합니다.

ORDER_BOOK:

{
  side: "buy",
  price: "0.00004477",
  quantity: "1789410.140359",
}

같은 side와 price를 갖는 오더북이 전달될 경우 quantity가 갱신됩니다. quantity가 "0"일 경우 그 side와 price를 갖는 오더북은 소멸됩니다.

레벨 별 각 필터는 오더북을 tick size의 10의 거듭제곱 단위로 묶어 표시합니다.

reset

boolean

데이터를 초기화해야 할 경우 reset을 true로 하고 전체 마켓데이터를 재전송합니다.
그 외의 경우 reset은 false이며 변경분만 보내집니다.

//response

{
  "channel": "marketdata",
  "market_id": <MARKET_ID>,
  "status":"ok",
  "lag":0,
  "<channels>": <data>
  "reset":true
}
// request

{
  "channel": "marketdata",
  "filter": ["ticker", "recent_trades"],
  "interval": 100,
  "market_id": "XRP-BTC",
  "type": "subscribe"
}

//response

{
  "channel":"marketdata",
  "market_id":"XRP-BTC",
  "status":"ok",
  "lag":0,
  "ticker":{
    "time":"2018-08-17T03:00:43.000Z",
    "last":"0.00004221",
    "low":"0.00003953",
    "high":"0.00004233",
    "change":"0.00000195",
    "base_volume":"119304953.57728445",
    "quote_volume":"4914.391934022046355"
  },
  "recent_trades":[
    {"price":"0.00004221","quantity":"555","time":"2018-08-17T02:56:17.249Z","side":"buy","tick_direction":"zeroup"},
   ],
"reset":true,
}