Request
요청은 JSON Object를 이용하며 응답 또한 JSON Object 입니다. 요청은 크게 ticket field, type field, format field 로 나누어지며 하나의 요청에 여러 개의 type field 를 명시할 수 있습니다. ticket field 와 format field 에 대해서는 요청 방법 및 포맷을 참고해주시기 바랍니다.
Request format[{Ticket Field},{Type Field},....,{Type Field},{Format Field}]
Type Field
수신하고 싶은 시세 정보를 나열하는 필드입니다.
is_only_snapshot, is_only_realtime 필드는 생략 가능하며 모두 생략시 스냅샷과 실시간 데이터 모두를 수신합니다.
필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
| type | String | 데이터 타입 - ticker: 현재가 | O | |
| codes | List | 마켓 코드 리스트 *대문자로 요청해야 합니다. | O | |
| is_only_snapshot | Boolean | 스냅샷 시세만 제공 | X | false |
| is_only_realtime | Boolean | 실시간 시세만 제공 | X | false |
Response
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": 31883000,
"high_price": 32310000,
"low_price": 31855000,
"trade_price": 32287000,
"prev_closing_price": 31883000.00000000,
"acc_trade_price": 78039261076.51241000,
"change": "RISE",
"change_price": 404000.00000000,
"signed_change_price": 404000.00000000,
"change_rate": 0.0126713295,
"signed_change_rate": 0.0126713295,
"ask_bid": "ASK",
"trade_volume": 0.03103806,
"acc_trade_volume": 2429.58834336,
"trade_date": "20230221",
"trade_time": "074102",
"trade_timestamp": 1676965262139,
"acc_ask_volume": 1146.25573608,
"acc_bid_volume": 1283.33260728,
"highest_52_week_price": 57678000.00000000,
"highest_52_week_date": "2022-03-28",
"lowest_52_week_price": 20700000.00000000,
"lowest_52_week_date": "2022-12-30",
"market_state": "ACTIVE",
"is_trading_suspended": false,
"delisting_date": null, // or "delisting_date" : {"year":2025,"month":10,"day":1}
"market_warning": "NONE",
"timestamp": 1676965262177,
"acc_trade_price_24h": 228827082483.70729000,
"acc_trade_volume_24h": 7158.80283560,
"stream_type": "REALTIME"
}