get https://api.upbit.com/v1/orderbook
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호가의 정보를 담고 있습니다.