Getting Quotes via REST API

1. Market Information and Ticker

Returns all market lists provided by Upbit.

curl --request GET \
  --url https://api.upbit.com/v1/market/all

The value of the returned market field s used for request parameters from other APIs.

For example, to see the Bitcoin price in the KRW market, input KRW-BTC in the market parameter.

For the current price of Bitcoin listed in the KRW market use the Ticker API.

curl --request GET \
  --url 'https://api.upbit.com/v1/ticker?markets=KRW-BTC'

Unlike other APIs, the Ticker API can request multiple Tickers separated by commas (,) in the request parameter with the 'markets' field name. This API is useful for bringing the status (snapshot) of a certain market in the digital asset market.

2. Candles

A "candle" is also referred as a bar and the basic bar for configuring a chart.
Of the candles that can be obtained through the Upbit market price API, each of the minute candles (minute bar) refers to comprehensive information on the market price in intervals of 1, 3, 5, 10, 30, and 60 minutes.

For example, request the following to get three 5-minute bars from the most recent KRW-BTC market :

curl --request GET \
  --url 'https://api.upbit.com/v1/candles/minutes/5?market=KRW-BTC&count=3'

The result of this request will bring three 5-minute bars based on the most recent time. Based on the characteristics of the minute bar, the basic time is 0, 5, 10, 15... to 55 minutes.

One thing to note is that you can request up to 200 candles at once. If you would like to request a larger number of candles, we recommend making sequential requests using the pagination technique.

We also offer a daily, monthly, and weekly candles in this way.

Use "to" request parameter

The to parameter that is used in the candle API follows the ISO8061 standard. Therefore, you can make a request as follows.

  1. Request one 1-minute bar from 12:00 AM based on UTC
    https://api.upbit.com/v1/candles/minutes/1?market=KRW-BTC&to=2018-07-24T00:00:00Z

  2. Request one 1-minute bar from 07:00 AM based on (UTC + 09:00)
    https://api.upbit.com/v1/candles/minutes/1?market=KRW-BTC&to=2018-09-27T07:00:00+09:00

When using the to parameter, please check that the URL encode is correct. If you try to make the above request right away through the browser, you can make the request as follows.

https://api.upbit.com/v1/candles/minutes/1?market=KRW-BTC&to=2018-09-27T07:00:00%2B09:00

3. Quotation Trades

"Trades" means that the transaction was established and you can obtain the trades details for today or recent days through the market price API.
Basically, when the API is called, it returns the most recent trade data of a specific digital asset.
For example, if the latest trade was two days ago, we return the trade data two days ago.

In addition, you can use the query string to check past data within 7 days of the most recent date of the trade.

You can request up to 200 trades at once. If you would like to request a larger number, we recommend making sequential requests by using the pagination technique.

📘

How to receive compressed API Response

After the (2019. 01.17) update, we offer gzip compression only for the market price API.
You can reduce the traffic cost by addingAccept-Encoding: gzip to the request header.