List Minute Candles

Retrieves the list of candles per minute.

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
Note on 1-Second Candles (Tick Candles) Data Retention
The 1-second candle API provides data for up to 3 months, based on the time of the request. If you request data beyond this period, the response may return an empty list or fewer items than the requested count. To check the available period, use the to parameter when making the query.
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 1-Second candle with candle_date_time = 2024-08-31T22:25:00 will not be created if no trades occur between 22:25:00 (inclusive) and 22:25:01 (exclusive).

Version Date Changes
v1.1.8 2024-10-30 Addition of List Second Candles
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.
Path Params
int32
enum
required

Candle unit in minutes.

Specify the candle unit to retrieve. Up to 240 minutes (4 hours) is supported.

Query Params
string
required

Trading pair code to query.

string

End time of the query range.
Retrieves candles before the specified time. If not specified, the most recent candles are returned.

Accepts ISO 8601 datetime format.

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

integer
Defaults to 1

Number of candles to retrieve.

Up to 200 candles are supported. Default: 1.

Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/json