get
https://api.coinone.co.kr/public/v2/orderbook//
특정 종목의 오더북 정보 조회 (호가 단위 별)
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
요청 제한: Public API 전체 합산 분당 1,200회 · IP 기준 · 자세히 보기
Path Params
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| quote_currency | String | 필수 | 마켓 기준 통화 *예: KRW |
| target_currency | String | 필수 | 조회하려는 종목의 심볼 *예: BTC |
Query Params
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| size | Enum | 선택 | 오더북 개수 (5, 10, 15, 16) 4개 값만 허용. 그 외 값은 107 에러를 반환합니다. 기본값: 15 |
| order_book_unit | Number | 선택 | 모아보기 단위로 종목 정보 조회 응답의 order_book_unit 값을 사용 Market API의 order_book_units 값 사용. 아닐경우, 표준 오더북 반환 기본값: 0.0 |
Response Body
| 필드 | 타입 | 설명 |
|---|---|---|
| result | String | 정상 반환 시 success, 에러 코드 반환 시 error |
| error_code | String | error 발생 시 에러코드 반환, 성공인 경우 0 반환 |
| timestamp | Number | 오더북의 최근 업데이트 시간 (ms) |
| id | String | order book id 값, id 값이 클수록 최신 OrderBook 정보 |
| quote_currency | String | 마켓 기준 통화 |
| target_currency | String | 조회 요청한 종목 |
| order_book_unit | NumberString | 현재 오더북 단위 |
| bids | Array[Object] | 매수 오더북 정보 |
| bids[].price | NumberString | 매수 호가 |
| bids[].qty | NumberString | 매수 수량 |
| asks | Array[Object] | 매도 오더북 정보 |
| asks[].price | NumberString | 매도 호가 |
| asks[].qty | NumberString | 매도 수량 |