upbit-api
upbit-api is an API that makes Upbit OpenAPI easy to use.
This api will support the Restful API and Websocket API.
It was created with Typescript and compiled into es2017.
Coverage Table
The § symbol includes auto-update:
autoMarketUpdate
or autoOrderBookUpdate
WS is WebSocket.
Method | Upbit | upbit-api | version |
---|
GET | /ticker | ticker § | 0.0.1+ |
GET | /orderbook | orderBook § | 0.2.0+ |
GET | /trades/ticks | ticks | 0.5.0+ |
GET | /candles/minutes/unit | candlesMinutes | 0.6.0+ |
GET | /market/all | allMarket | 0.7.0+ |
GET | /candles/days | candlesDay | 0.9.0+ |
GET | /candles/weeks | candlesWeek | 0.10.0+ |
GET | /candles/months | candlesMonth | 0.10.0+ |
GET | /accounts | Unsupported | At least 0.11.0 |
GET | /orders/chance | Unsupported | At least 0.11.0 |
GET | /order | Unsupported | At least 0.11.0 |
GET | /orders | Unsupported | At least 0.11.0 |
POST | /orders | Unsupported | At least 0.11.0 |
DELETE | /order | Unsupported | At least 0.11.0 |
GET | /withdraws | Unsupported | At least 0.11.0 |
GET | /withdraw | Unsupported | At least 0.11.0 |
GET | /withdraws/chance | Unsupported | At least 0.11.0 |
POST | /withdraws/coin | Unsupported | At least 0.11.0 |
POST | /withdraws/krw | Unsupported | At least 0.11.0 |
GET | /deposits | Unsupported | At least 0.11.0 |
WS | ticker | Unsupported | At least 0.11.0 |
WS | trade | Unsupported | At least 0.11.0 |
WS | orderbook | Unsupported | At least 0.11.0 |
ticker(market)
Create new Market
object arrays.
Parameter | Type | Description |
---|
market | string or Array<string> | 'KRW-BTC' or ['KRW-BTC', 'KRW-XRP'] |
Market class
Parameter | Type | Description |
---|
market | string | ex) KRW, BTC, USDT ... |
coin | string | ex) BTC, ETH, XRP ... |
marketCode | string | ex) KRW-BTC, KRW-XRP ... |
tradeTime | Date | trade time |
price | number | price |
open | number | Market value |
high | number | Highest price |
low | number | Lowest price |
prevClose | number | the closing price of the previous day |
change | number | EVEN: Mixture RISE: Rise FALL: Fall |
changePrice | number | Absolute value of change amount |
changeRate | number | Absolute value of change rate |
signedChangePrice | number | signed change Price |
signedChangeRate | number | signed change rate |
tradeVolume | number | Latest volume |
accTradePrice | number | accTradePrice |
accTradePrice24 | number | accTradePrice24 |
accTradeVolume | number | Cumulative transaction amount(UTC 0) |
accTradeVolume24 | number | Cumulative transaction amount for 24 hours |
high52wPrice | number | 52 Weeks New Highest Price |
high52wDate | Date | 52 Weeks New Highest Price'Date |
low52wPrice | number | 52 Weeks New Lowest Price |
low52wDate | Date | 52 Weeks New Lowest Price's Date |
lastUpdate | Date | The time when this object updated |
autoMarketUpdate(market, time , errorHandler, callback?)
Updates object market
every specified time
time.
Parameter | Type | Description |
---|
market | Market or Array<Market> | Market object that will be updated. |
time | number | Frequency to update (in milliseconds) |
errorHandler | function, (error) => any | error handler |
callback | function, (market) => any | optional, this function called when object updated. |
OrderBook(market)
Create new OrderBook
object arrays.
Parameter | Type | Description |
---|
market | string or Array<string> | 'KRW-BTC' or ['KRW-BTC', 'KRW-XRP'] |
OrderBook class
Name | Type | Description |
---|
market | string | ex) KRW, BTC, USDT ... |
coin | string | ex) BTC, ETH, XRP ... |
marketCode | string | ex) KRW-BTC, KRW-XRP ... |
lastUpdate | Date | The time when this object updated |
askList | Array<Order > | Ask order list |
bidList | Array<Order > | Bid order list |
totalAsk | number | total ask |
totalBid | number | total bid |
Order class
Name | Type | Description |
---|
price | number | price of order |
size | number | size of order |
autoOrderBookUpDate(orderBook, time , errorHandler, callback?)
Updates object OrderBook
every specified time
time.
Parameter | Type | Description |
---|
orderBook | OrderBook or Array<OrderBook> | OrderBook object that will be updated. |
time | number | Frequency to update (in milliseconds) |
errorHandler | function, (error) => any | error handler |
callback | function, (orderBook) => any | optional, this function called when object updated. |
ticks(market, count?, to?, cursor?)
Create new Trade
object arrays.
Parameter | Type | Description |
---|
market | string or Array<string> | 'KRW-BTC' or ['KRW-BTC', 'KRW-XRP'] |
count | number | count |
to | string | HHmmss or HH:mm:ss |
cursor | number | sequential_id |
Trade class
Name | Type | Description |
---|
market | string | ex) KRW, BTC, USDT ... |
coin | string | ex) BTC, ETH, XRP ... |
marketCode | string | ex) KRW-BTC, KRW-XRP ... |
lastUpdate | Date | The time when this object updated |
tradeTime | Date | The time when traded |
price | number | price of this trade |
volume | number | volume of this trade |
prev_closing_price | number | prev_closing_price |
change_price | number | price - prev_closing_price |
isAsk | boolean | Trade type |
sequential_id | number | Transaction Number(Unique) |
candlesMinutes(market, unit?, count?, to?)
Create Candle
object arrays.
Parameter | Type | Description |
---|
market | string or Array<string> | 'KRW-BTC' or ['KRW-BTC', 'KRW-XRP'] |
unit | number | 1, 3, 5, 15, 10, 30, 60, 240 |
count | number | count |
to | string | yyyy-MM-dd'T'HH:mm:ssXXX |
Candle class
Name | Type | Description |
---|
market | string | ex) KRW, BTC, USDT ... |
coin | string | ex) BTC, ETH, XRP ... |
marketCode | string | ex) KRW-BTC, KRW-XRP ... |
timestamp | number | The time at which the last tick was stored in the candle. |
candleDateTimeUTC | Date | Standard time of the candle (UTC basis) |
candleDateTimeKST | Date | Standard time of the candle (KST basis) |
open | number | Market value |
high | number | Highest price |
low | number | Lowest price |
accTradePrice | number | Candle's accTradePrice |
accTradeVolume | number | Candle's cumulative transaction amount |
lastUpdate | Date | The time when this object updated |
MinutesCandle class
MinutesCandle
extends Candle
Name | Type | Description |
---|
unit | number | minutes. Possible values: 1, 3, 5, 15, 10, 30, 60, 240 |
DayCandle class
DayCandle
extends Candle
Name | Type | Description |
---|
prevClosingPrice | number | the closing price of the previous day |
convertedTradePrice | number | a price converted into denominations |
changePrice | number | value of change amount |
changeRate | number | value of change rate |
WeekMonthCandle class
WeekMonthCandle
extends Candle
Name | Type | Description |
---|
firstDayOfPeriod | number | first day of period |
allMarket()
List of markets that can be traded at Upbit.
Name | Type | Description |
---|
market | string | Market information provided by Upbit, ex) BTC-XRP |
korean_name | string | Korean name ex) 비트코인 |
english_name | string | English name ex) Bitcoin |