v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

체결(Trade)

페어 체결 이력 조회

지정한 페어의 최근 체결 목록을 조회합니다.

get/trades/ticks

Query parameters

marketstring required

조회하고자 하는 페어(거래쌍)

Example:KRW-BTC

tostring

조회 대상 일자 내 조회 기간의 종료 시각(UTC). 지정한 조회 일자 내에서 특정 시간대의 체결 내역을 조회하고자 하는 경우 선택적으로 사용할 수 있는 파라미터입니다.

HHmmss 또는 HH:mm:ss 형식의 시간 포맷으로 입력합니다. 체결 목록이 지정한 시간부터 시간 역순으로 반환됩니다.

[예시] days_ago=1&to=130000 으로 조회하는 경우 1일 전(어제) UTC 기준 오후 1시 정각 이전 체결 이력을 최신순으로 반환

countinteger

조회하고자 하는 체결 내역의 개수. 최대 500개 조회를 지원하며 기본 값은 1입니다.

Example:500

cursorstring

Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 체결의 "sequential_id” 값을 이 필드에 입력하여 해당 체결 직전 데이터부터 “count”개의 이전 체결 이력을 이어서 조회할 수 있습니다.

Example:abcd1234

days_agointeger

체결 내역 조회 대상 일자와 요청 시점과의 일 단위 offset. 체결 내역은 체결 일을 지정하여 조회해야 하며 최대 7일의 조회 기간을 지원합니다. 일자 구분은 UTC를 기준으로 합니다.

1 이상 7 이하의 정수형으로 입력합니다. 빈 값으로 입력할 경우, 요청 일자에 발생한 체결 목록을 반환하며, 7을 입력하면 7일 이전에 발생한 체결 목록을 시간 역순(최신 체결 순)으로 반환합니다.

Example:1

Response

List of trades

marketstring required

페어(거래쌍)의 코드

[예시] "KRW-BTC"

trade_date_utcstring required

체결 일자 (UTC 기준)

[형식] yyyy-MM-dd

trade_time_utcstring required

체결 시각 (UTC 기준)

[형식] HH:mm:ss

timestampinteger required

체결 시각의 밀리초단위 타임스탬프

trade_pricenumber double required

최근 체결 가격

trade_volumenumber double required

최근 거래 수량

prev_closing_pricenumber double required

전일 종가 (UTC 0시 기준)

change_pricenumber double required

전일 종가 대비 가격 변화. "trade_price" - "prev_closing_price"로 계산되며, 현재 종가가 전일 종가보다 얼마나 상승 또는 하락했는지를 나타냅니다.

양수(+): 현재 종가가 전일 종가보다 상승한 경우
음수(-): 현재 종가가 전일 종가보다 하락한 경우

ask_bid'ASK' | 'BID' required

매수/매도 주문 구분

sequential_idinteger required

체결의 유일 식별자. 해당 필드는 체결 순서를 보장하지 않습니다.

Example response

[
  {
    "market": "KRW-BTC",
    "trade_date_utc": "2025-06-17",
    "trade_time_utc": "16:59:59",
    "timestamp": 1750749886904,
    "trade_price": 142340000,
    "trade_volume": 100000000,
    "prev_closing_price": 140908000,
    "change_price": 100000000,
    "ask_bid": "ASK, BID",
    "sequential_id": 17501795992650000
  }
]