List Day Candles

get

https://{region}-api.upbit.com/v1/candles/days

Retrieves the list of candles per day.

Check the proper endpoint based on your region.

The examples in this page is written using Singapore fiat code(SGD). Set the quote currency to match your region. The base_url differs by country/region. Make sure to specify the correct region value for your environment.

- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com

Candles are created only when trades occur within the given time interval.

If no trades occur between the start and end time of a candle, it will not be created and therefore will not appear in the API response. For example, a Day candle with candle_date_time = 2024-08-31T00:00:00 will not be created if no trades occur between 2024-08-31T00:00:00 (inclusive) and 2024-09-01T00:00:00 (exclusive).

Rate Limit

Up to 10 calls per second are allowed. This is measured on an IP basis and request counts are shared within the exchange 'candle' group.

Query Params

market

string

required

Trading pair code representing the market.

string

End time of the query period.
Retrieves candles that occurred before the specified time.
If not provided, the most recent candles based on the request time are returned by default.

Specify the time in ISO 8601 datetime format.
When making the actual request, ensure that any spaces or special characters in the datetime string are properly URL-encoded.

[Example]
2025-06-24T04:56:53Z (UTC)
2025-06-24 04:56:53 (UTC)
2025-06-24T13:56:53+08:00 (SGT)

count

integer

Defaults to 1

Number of candles to retrieve.
Supports up to 200 candles.
Default: 1.

converting_price_unit

string

Conversion currency for the closing price.
You can optionally specify a currency to convert the closing price. When used, the response includes an additional field, converted_trade_price.

[Example]
If specified as “SGD”, the closing price is returned in SGD.

Responses

200List of candles

400error object

404error object