v1

latestOpenAPI 3.1.02026-07-26420360.1 KB

체결(Trade) 내역 조회

최근 체결된 거래 내역을 조회합니다.

get/trades/ticks

Query parameters

marketstring required

거래 대상 페어의 고유 심볼

예시) KRW-BTC

tostring

조회 기준 시각(KST). 해당 시각 이전 데이터를 조회하며, 00:00:00–23:59:59 사이로 입력 가능

형식) HHmmss 또는 HH:mm:ss

미입력 시 daysAgo도 입력하지 않았을 경우 현재 시각 기준 최근 데이터 조회, daysAgo 입력했을 경우 해당 일자의 00:00:00 기준 최근 데이터 조회

countinteger

조회할 내역 수(1–500)

cursorstring

페이지네이션을 위한 커서 값. 이전 응답의 sequential_id 값을 입력하여 다음 페이지를 조회합니다.

daysAgointeger

과거 체결 데이터 조회 범위(1–7일). 미입력 시 현재 시점 기준 최근 데이터 조회

Response

200

marketstring

거래 대상 페어의 고유 심볼

예시) KRW-BTC

trade_date_utcstring

체결 일자(UTC)

형식) yyyy-MM-dd

trade_time_utcstring

체결 시각(UTC)

형식) HH:mm:ss

timestampstring int64

체결 시각(Unix timestamp, Unit: ms)

trade_pricenumber double

체결 가격

trade_volumenumber double

체결량

prev_closing_pricenumber double

전일 종가(UTC 0시 기준)

change_pricenumber double

전일 종가 대비 변화 금액

ask_bid'BID' | 'ASK'

주문 종류

BID: 매수
ASK: 매도

sequential_idinteger

체결 고유 ID. 체결의 유일성을 식별하는 값으로 사용할 수 있으나 체결 순서를 보장하지 않습니다.

Example response

[
  {
    "market": "KRW-BTC",
    "trade_date_utc": "2018-04-18",
    "trade_time_utc": "10:19:58",
    "trade_price": 8616000,
    "trade_volume": 0.03060688,
    "prev_closing_price": 8450000,
    "change_price": 166000,
    "ask_bid": "ASK"
  }
]