v1

latestOpenAPI 3.0.12026-07-24510443.1 KB
현재가(Ticker)

페어 단위 현재가 조회

지정한 페어의 현재가를 조회합니다. 요청 시점 기준으로 해당 페어의 티커 스냅샷이 반환됩니다.

get/ticker

Query parameters

marketsstring required

조회하고자 하는 페어(거래쌍) 목록. 2개 이상의 페어에 대해 조회하고자 하는 경우 쉼표(,)로 구분된 문자열 형식으로 요청합니다.

[예시] KRW-BTC,KRW-ETH,BTC-ETH,BTC-XRP

Example:KRW-BTC,KRW-ETH

Response

List of tickers

marketstring required

페어(거래쌍)의 코드

[예시] "KRW-BTC"

trade_datestring required

최근 체결 일자 (UTC 기준)

[형식] yyyyMMdd

trade_timestring required

최근 체결 시각 (UTC 기준)

[형식] HHmmss

trade_date_kststring required

최근 체결 일자 (KST 기준)

[형식] yyyyMMdd

trade_time_kststring required

최근 체결 시각 (KST 기준)

[형식] HHmmss

trade_timestampinteger required

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

opening_pricenumber double required

시가. 해당 페어의 첫 거래 가격입니다.

high_pricenumber double required

고가. 해당 페어의 최고 거래 가격입니다.

low_pricenumber double required

저가. 해당 페어의 최저 거래 가격입니다.

trade_pricenumber double required

종가. 해당 페어의 현재 가격입니다.

prev_closing_pricenumber double required

전일 종가 (UTC 0시 기준)

change'EVEN' | 'RISE' | 'FALL' required

가격 변동 상태

  • EVEN: 보합
  • RISE: 상승
  • FALL: 하락
change_pricenumber double required

전일 종가 대비 가격 변화(절대값) "trade_price" - "prev_closing_price"로 계산됩니다.

change_ratenumber double required

전일 종가 대비 가격 변화 (절대값) ("trade_price" - "prev_closing_price") ÷ "prev_closing_price" 으로 계산됩니다.

signed_change_pricenumber double required

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

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

전일 종가 대비 가격 변화율 ("trade_price" - "prev_closing_price") ÷ "prev_closing_price" 으로 계산됩니다.

  • 양수(+): 가격 상승
  • 음수(-): 가격 하락

[예시] 0.015 = 1.5% 상승

trade_volumenumber double required

최근 거래 수량

acc_trade_pricenumber double required

누적 거래 금액 (UTC 0시 기준)

acc_trade_price_24hnumber double required

24시간 누적 거래 금액

acc_trade_volumenumber double required

누적 거래량 (UTC 0시 기준)

acc_trade_volume_24hnumber double required

24시간 누적 거래량

highest_52_week_pricenumber double required

52주 신고가

highest_52_week_datestring required

52주 신고가 달성일

[형식] yyyy-MM-dd

lowest_52_week_pricenumber double required

52주 신저가

lowest_52_week_datestring required

52주 신저가 달성일

[형식] yyyy-MM-dd

timestampinteger required

현재가 정보가 반영된 시각의 타임스탬프(ms)

Example response

[
  {
    "market": "KRW-BTC",
    "trade_timestamp": 1750179599265,
    "opening_price": 142340000,
    "high_price": 142340000,
    "low_price": 142340000,
    "trade_price": 142340000,
    "prev_closing_price": 140908000,
    "change": "FALL",
    "change_price": 100000000,
    "change_rate": 0.0031057175,
    "signed_change_price": -454000,
    "signed_change_rate": -0.0031057175,
    "trade_volume": 0.0068,
    "acc_trade_price": 72976655137.21983,
    "acc_trade_price_24h": 344100708901.19037,
    "acc_trade_volume": 501.38991748,
    "acc_trade_volume_24h": 2389.39562434,
    "highest_52_week_price": 163325000,
    "highest_52_week_date": "2025-01-20",
    "lowest_52_week_price": 72100000,
    "lowest_52_week_date": "2024-08-05",
    "timestamp": 1750746915062
  }
]