Home이용 안내API 레퍼런스변경 내역
API 레퍼런스

오더북 조회

특정 종목의 오더북 정보 조회 (호가 단위 별)

Path Params

fieldtyperequired/optionaldescription
quote_currencyStringrequired마켓 기준 통화
*예: KRW
target_currencyStringrequired조회하려는 종목의 심볼
*예: BTC

Query Params

fieldtyperequired/optionaldescription
sizeEnumoptional오더북 개수 (기본값 15)
(5, 10, 15, 16) 4개 값만 허용
order_book_unitNumberoptional모아보기 단위로 종목 정보 조회 응답의 order_book_unit 값을 사용
(기본값 0.0)

Response Body

fieldtypedescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
timestampNumber오더북의 최근 업데이트 시간 (ms)
idStringorder book id 값, id 값이 클수록 최신 OrderBook 정보
quote_currencyString마켓 기준 통화
target_currencyString조회 요청한 종목
order_book_unitNumberString현재 오더북 단위
bidsArray[Object]매수 오더북 정보
-priceNumberString매수 호가
-qtyNumberString매수 수량
asksArray[Object]매도 오더북 정보
-priceNumberString매도 호가
-qtyNumberString매도 수량
Path Params
string
required
Defaults to KRW

마켓 기준 통화

string
required
Defaults to BTC

조회하려는 종목의 심볼

Query Params
string
enum
Defaults to 15

조회 하려는 오더북 개수 (기본값: 15)

Allowed:
int32

Market API의 order_book_units 값 사용. 아닐경우, 표준 오더북 반환

Response

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json