HomeGuidesAPI ReferenceAnnouncements
AnnouncementsGuidesAPI ReferenceSupportFAQ
API Reference

ํ˜ธ๊ฐ€ (Orderbook)

๐Ÿ“˜

v1.4.4 ํ˜ธ๊ฐ€ ๋ชจ์•„๋ณด๊ธฐ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ (์›ํ™”๋งˆ์ผ“๋งŒ ์ง€์›)

v1.4.4 ๋ถ€ํ„ฐ level ํ•ญ๋ชฉ์„ ํ†ตํ•ด ํ˜ธ๊ฐ€ ๋ชจ์•„๋ณด๊ธฐ๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
์ง€์›ํ•˜๋Š” ์ „์ฒด ๋‹จ์œ„๋Š” ์•„๋ž˜์™€ ๊ฐ™์œผ๋ฉฐ ๊ฐ ์ข…๋ชฉ๋ณ„ ํ˜ธ๊ฐ€ ๋‹จ์œ„์— ๋”ฐ๋ผ ์ง€์›ํ•˜๋Š” ๋‹จ์œ„๊ฐ€ ๋‹ค๋ฆ…๋‹ˆ๋‹ค.
*์ข…๋ชฉ๋ณ„๋กœ ์ง€์›ํ•˜๋Š” ๋ชจ์•„๋ณด๊ธฐ ๋‹จ์œ„๋Š” v1/orderbook/supported_levels ์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
ํ•ด๋‹น ์ข…๋ชฉ์—์„œ ์ง€์›ํ•˜์ง€ ์•Š๋Š”level ๋‹จ์œ„๋ฅผ ๋„ฃ์„ ๊ฒฝ์šฐ ์ˆ˜์‹ ๋ฐ›์œผ์‹ค ๋ฐ์ดํ„ฐ๊ฐ€ ์—†์œผ๋‹ˆ ์ฃผ์˜ํ•ด์ฃผ์„ธ์š”

- 100000000
- 10000000
- 1000000
- 100000
- 10000
- 1000
- 100
- 10
- 1
- 0
- 0.1
- 0.01
- 0.001
- 0.0001    
- 0.00001   
- 0.000001 
- 0.0000001

๐Ÿ“˜

v1.1.0 Orderbook Unit ๊ฐฏ์ˆ˜ ์ปค์Šคํ…€ ์ˆ˜์‹ ๊ธฐ๋Šฅ ์ถ”๊ฐ€

v1.1.0 ๋ถ€ํ„ฐ orderbook ํƒ€์ž…์˜ ํŒจํ‚ท์— ํ•œํ•˜์—ฌ Orderbook Unit์˜ ๊ฐฏ์ˆ˜๋ฅผ ์ตœ๋Œ€ ์ œ๊ณต ๊ฐฏ์ˆ˜ (15๊ฐœ) ์•ˆ์—์„œ ์›ํ•˜๋Š” ๋งŒํผ ์กฐ์ ˆํ•˜์—ฌ ํ˜ธ์ถœ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ์กด์˜ codes ํ•ญ๋ชฉ์— ์‹œ์„ธ ์ข…๋ชฉ๊ณผ ์›ํ•˜๋Š” Unit ๊ฐฏ์ˆ˜๋ฅผ ๋„ฃ์–ด์ฃผ์‹œ๋ฉด ๋ฉ๋‹ˆ๋‹ค.

ํ˜•์‹: {code}.{count}
ex) "KRW-BTC.5", "BTC-XRP.3"

Response

ํ•„๋“œ๋ช…
์ถ•์•ฝํ˜• (format: SIMPLE)
๋‚ด์šฉ
ํƒ€์ž…๊ฐ’
typetyํƒ€์ž…Stringorderbook : ํ˜ธ๊ฐ€
codecd๋งˆ์ผ“ ์ฝ”๋“œ (ex. KRW-BTC)String
total_ask_sizetasํ˜ธ๊ฐ€ ๋งค๋„ ์ด ์ž”๋Ÿ‰Double
total_bid_sizetbsํ˜ธ๊ฐ€ ๋งค์ˆ˜ ์ด ์ž”๋Ÿ‰Double
orderbook_unitsobuํ˜ธ๊ฐ€List of Objects
ask_priceap๋งค๋„ ํ˜ธ๊ฐ€Double
bid_pricebp๋งค์ˆ˜ ํ˜ธ๊ฐ€Double
ask_sizeas๋งค๋„ ์ž”๋Ÿ‰Double
bid_sizebs๋งค์ˆ˜ ์ž”๋Ÿ‰Double
timestamptmsํƒ€์ž„์Šคํƒฌํ”„ (millisecond)Long
levellvํ˜ธ๊ฐ€ ๋ชจ์•„๋ณด๊ธฐ ๋‹จ์œ„ (default: 0, ๊ธฐ๋ณธ ํ˜ธ๊ฐ€๋‹จ์œ„)
*ํ˜ธ๊ฐ€ ๋ชจ์•„๋ณด๊ธฐ ๊ธฐ๋Šฅ์€ ์›ํ™”๋งˆ์ผ“(KRW)์—์„œ๋งŒ ์ง€์›ํ•˜๋ฏ€๋กœ BTC, USDT ๋งˆ์ผ“์˜ ๊ฒฝ์šฐ 0๋งŒ ์กด์žฌํ•ฉ๋‹ˆ๋‹ค.
*์ข…๋ชฉ๋ณ„ ์ง€์›ํ•˜๋Š” ๋ชจ์•„๋ณด๊ธฐ ๋‹จ์œ„๋Š” v1/orderbook/supported_levels ์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
Double๋ชจ์•„๋ณด๊ธฐ ๋‹จ์œ„

Example

Request

level ๊ฐ’์€ ํ•„์ˆ˜๊ฐ€ ์•„๋‹ˆ๋ฉฐ, ์ œ์™ธ๋  ๊ฒฝ์šฐ DEFUALT(0), ๊ธฐ๋ณธ ํ˜ธ๊ฐ€๋‹จ์œ„๋กœ ๋‚ด๋ ค๊ฐ‘๋‹ˆ๋‹ค.

[
  {
    "ticket": "test"
  },
  {
    "type": "orderbook",
    "codes": [
      "KRW-BTC",
      "KRW-ETH.3"
    ],
    "level": 10000
  },
  {
    "format": "DEFAULT"
  }
]

์ข…๋ชฉ๋ณ„๋กœ ๊ฐ๊ธฐ๋‹ค๋ฅธ ๋ชจ์•„๋ณด๊ธฐ level ๊ฐ’์„ ์ง€์ •ํ•˜๊ธฐ ์œ„ํ•ด์„œ๋Š” ์•„๋ž˜์™€ ๊ฐ™์ด ์š”์ฒญํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

[  
    {  
        "ticket": "test"  
    },  
    {  
        "type": "orderbook",  
        "codes": [  
            "KRW-BTC"
        ],  
        "level": 10000  
    },  
    {  
        "type": "orderbook",  
        "codes": [  
            "KRW-BTT"  
        ],  
        "level": 0  
    },  
    {  
        "format": "DEFAULT"  
    }  
]  

Response

{
  "type": "orderbook",
  "code": "KRW-BTC",
  "timestamp": 1704867306396,
  "total_ask_size": 7.3262086,
  "total_bid_size": 29.27948667,
  "orderbook_units": [
    {
      "ask_price": 61820000,
      "bid_price": 61800000,
      "ask_size": 1.44125174,
      "bid_size": 8.95463042
    },
    {
      "ask_price": 61830000,
      "bid_price": 61790000,
      "ask_size": 0.025,
      "bid_size": 2.65037043
    },
    {
      "ask_price": 61840000,
      "bid_price": 61780000,
      "ask_size": 0.00161707,
      "bid_size": 0.26890135
    },
    {
      "ask_price": 61850000,
      "bid_price": 61770000,
      "ask_size": 0.06059401,
      "bid_size": 0.63729629
    },
    {
      "ask_price": 61860000,
      "bid_price": 61760000,
      "ask_size": 0.08702514,
      "bid_size": 0.33709503
    },
    {
      "ask_price": 61870000,
      "bid_price": 61750000,
      "ask_size": 0.21193036,
      "bid_size": 0.62382278
    },
    {
      "ask_price": 61880000,
      "bid_price": 61740000,
      "ask_size": 0.95938473,
      "bid_size": 1.14006691
    },
    {
      "ask_price": 61890000,
      "bid_price": 61730000,
      "ask_size": 0.35962299,
      "bid_size": 0.90819049
    },
    {
      "ask_price": 61900000,
      "bid_price": 61720000,
      "ask_size": 1.02822787,
      "bid_size": 5.32751807
    },
    {
      "ask_price": 61910000,
      "bid_price": 61710000,
      "ask_size": 0.09103111,
      "bid_size": 0.54694518
    },
    {
      "ask_price": 61920000,
      "bid_price": 61700000,
      "ask_size": 2.86063421,
      "bid_size": 1.90083344
    },
    {
      "ask_price": 61930000,
      "bid_price": 61690000,
      "ask_size": 0.11484434,
      "bid_size": 3.40407167
    },
    {
      "ask_price": 61940000,
      "bid_price": 61680000,
      "ask_size": 0.01953653,
      "bid_size": 1.23800334
    },
    {
      "ask_price": 61950000,
      "bid_price": 61670000,
      "ask_size": 0.02769878,
      "bid_size": 0.24941321
    },
    {
      "ask_price": 61960000,
      "bid_price": 61660000,
      "ask_size": 0.03780972,
      "bid_size": 1.09232806
    }
  ],
  "stream_type": "REALTIME",
  "level": 10000
}