HomeGuidesAPI ReferenceAnnouncements
AnnouncementsGuidesAPI ReferenceSupportFAQ
API Reference

호가 정보 조회

📘

v1.4.4 호가 모아보기 기능 추가 (원화마켓만 지원)

v1.4.4 부터 level 항목을 통해 호가 모아보기를 지원합니다.
지원하는 전체 단위는 아래와 같으며 각 종목별 호가 단위에 따라 지원하는 단위가 다릅니다.
*종목별로 지원하는 모아보기 단위는 v1/orderbook/supported_levels 에서 확인하실 수 있습니다.
해당 종목에서 지원하지 않는level 단위를 넣을 경우 빈 리스트가 내려가니 주의해주세요

- 100000000
- 10000000
- 1000000
- 100000
- 10000
- 1000
- 100
- 10
- 1
- 0
- 0.1
- 0.01
- 0.001
- 0.0001    
- 0.00001   
- 0.000001  
- 0.0000001 

Request Parameters

필드설명타입
markets *반점으로 구분되는 마켓 코드 (ex. KRW-BTC, BTC-ETH)String
level호가 모아보기 단위 (0인 경우 기본 호가 단위. 해당 기능은 원화마켓(KRW)에서만 지원)Double

Response

필드설명타입
market종목 코드String
timestamp호가 생성 시각Long
total_ask_size호가 매도 총 잔량Double
total_bid_size호가 매수 총 잔량Double
orderbook_units호가List of Objects
ask_price매도호가Double
bid_price매수호가Double
ask_size매도 잔량Double
bid_size매수 잔량Double
level호가 모아보기 단위 (default: 0, 기본 호가단위)
*호가 모아보기 기능은 원화마켓(KRW)에서만 지원하므로 BTC, USDT 마켓의 경우 0만 존재합니다.
*종목별 지원하는 모아보기 단위는 v1/orderbook/supported_levels 에서 확인하실 수 있습니다.
Double

orderbook_unit 리스트에는 15호가 정보가 들어가며 차례대로 1호가, 2호가 ... 15호가의 정보를 담고 있습니다.

Language