v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

호가(Orderbook)

호가 조회

지정한 종목들의 실시간 호가(Orderbook) 정보를 조회합니다.

get/orderbook

Query parameters

marketsstring required

조회하고자 하는 페어(거래쌍) 목록. 2개 이상의 페어에 대해 조회하고자 하는 경우 쉼표(,)로 구분된 문자열 형식으로 요청합니다.

[예시] KRW-BTC,KRW-ETH,BTC-ETH,BTC-XRP

Example:KRW-BTC,KRW-ETH

levelstring

호가 모아보기 단위. 원화마켓(KRW)에서만 지원하는 기능으로, 지정한 단위로 ask/bid price와 size를 모아(group) 조회할 수 있습니다. 숫자 형식의 String으로 요청합니다.

0 또는 1 이상의 모아보기 단위인 경우 소수점을 포함하지 않은 정수형 문자열로, 1 미만의 소수점 단위 모아보기 단위인 경우 double형 문자열로 요청합니다. 미지정시 기본값은 0입니다.

countinteger

조회하고자 하는 호가 쌍의 개수. 최고 매수 호가 - 최저 매도 호가의 쌍을 기준으로, 지정한 개수 만큼의 호가 쌍 정보가 반환됩니다. 미지정시 기본값은 30입니다.

Example:10

Response

List of orderbook

marketstring required

페어(거래쌍)의 코드

[예시] "KRW-BTC"

timestampinteger required

조회 요청 시각의 타임스탬프 (ms)

total_ask_sizenumber double required

현재 호가의 전체 매도 잔량 합계

total_bid_sizenumber double required

현재 호가의 전체 매수 잔량 합계

levelnumber double required

해당 호가가 적용된 가격 단위

Example response

[
  {
    "market": "KRW-BTC",
    "timestamp": 1750749886904,
    "total_ask_size": 10.64580882,
    "total_bid_size": 8.26105616,
    "orderbook_units": [
      {
        "ask_price": 146030000,
        "bid_price": 146000000,
        "ask_size": 0.74547181,
        "bid_size": 0.20338834
      }
    ],
    "level": 10000
  }
]