Request

요청은 크게 ticket field, type field, format field 로 분류되며 하나의 요청에 여러 개의 type field 를 명시할 수 있습니다. 자세한 사항은 요청 방법 및 포맷 페이지를 확인해주시기 바랍니다.

Type Field

수신하고 싶은 시세 정보를 나열하는 필드입니다.
is_only_snapshot, is_only_realtime 필드는 생략할 수 있으며 둘 다 생략할 경우 스냅샷과 실시간 데이터 모두 수신합니다.

필드명

타입

내용

필수 여부

기본 값

type

String

데이터 타입
-ticker: 현재가

O

codes

List

마켓 코드 리스트
- 대문자로 요청해야 합니다.

O

isOnlySanpshot

Boolean

스냅샷 시세만 제공

X

false

isOnlyRealtime

Boolean

실시간 시세만 제공

X

false

Response

필드명

축약형

(format

:SIMPLE)

내용

타입

type

ty

타입

String

ticker: 현재가

code

cd

마켓 코드 (ex. KRW-BTC)

String

opening_price

op

시가

Double

high_price

hp

저가

Double

low_price

lp

고가

Double

trade_price

tp

현재가

Double

prev_closing_price

pcp

전일 종가

Double

change

c

전일 대비

String

RISE: 상승
EVEN: 보합
FALL: 하락

change_price

cp

부호 없는 전일 대비 값

Double

signed_change_price

scp

전일 대비 값

Double

change_rate

cr

부호 없는 전일 대비 등락율

Double

signed_change_rate

scr

전일 대비 등락율

Double

trade_volume

tv

가장 최근 거래량

Double

acc_trade_volume

atv

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

Double

acc_trade_volume_24h

atv24h

24시간 누적 거래량

Double

acc_trade_price

atp

누적 거래대금(KST 0시 기준)

Double

acc_trade_price_24h

atp24h

24시간 누적 거래대금

Double

trade_date

tdt

최근 거래 일자(KST)

String

yyyyMMdd

trade_time

ttm

최근 거래 시각(KST)

String

HHmmss

trade_timestamp

ttms

체결 타임스탬프 (milliseconds)

Long

ask_bid

ab

매수/매도 구분

String

ASK : 매도
BID : 매수

acc_ask_volume

aav

누적 매도량

Double

acc_bid_volume

abv

누적 매수량

Double

highest_52_week_price

h52wp

52주 최고가

Double

highest_52_week_date

h52wdt

52주 최고가 달성일

String

yyyy-MM-dd

lowest_52_week_price

l52wp

52주 최저가

Double

lowest_52_week_date

l52wdt

52주 최저가 달성일

String

yyyy-MM-dd

market_state

ms

거래상태

String

is_trading_suspended

its

거래 정지 여부

Boolean

delisting_date

dd

거래지원 종료일

Date

market_warning

mw

유의 종목 여부

String

NONE : 해당없음
CAUTION : 거래유의

timestamp

tms

타임스탬프 (millisecond)

Long

stream_type

st

스트림 타입

String

SNAPSHOT : 스냅샷
REALTIME : 실시간

Example

Request

  • KRW-BTC, KRW-ETH
[
  {
    "ticket": "test example"
  },
  {
    "type": "ticker",
    "codes": [
      "KRW-BTC",
      "KRW-ETH"
    ]
  },
  {
    "format": "DEFAULT"
  }
]

Response

{
    "type": "ticker",
    "code": "KRW-BTC",
    "opening_price": 484500,
    "high_price": 493100,
    "low_price": 472500,
    "trade_price": 493100,
    "prev_closing_price": 484500,
    "change": "RISE",
    "change_price": 8600,
    "signed_change_price": 8600,
    "change_rate": 0.01775026,
    "signed_change_rate": 0.01775026,
    "trade_volume": 1.2567,
    "acc_trade_volume": 225.622,
    "acc_trade_volume_24h": 13386.15417512,
    "acc_trade_price": 108663718.238256,
    "acc_trade_price_24h": 8230696760.346009,
    "trade_date": "20240910",
    "trade_time": "091617",
    "trade_timestamp": 1725927377820,
    "ask_bid": "BID",
    "acc_ask_volume": 106.7561,
    "acc_bid_volume": 118.8659,
    "highest_52_week_price": 999999000,
    "highest_52_week_date": "2024-06-18",
    "lowest_52_week_price": 1000,
    "lowest_52_week_date": "2024-06-18",
    "market_state": "ACTIVE",
    "is_trading_suspended": false,
    "delisting_date": null,
    "market_warning": "NONE",
    "timestamp": 1725927377931,
    "stream_type": "REALTIME"
}