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

Unit of minute candles.
Specify the candle unit to retrieve minute candles.
Supports up to 240 minutes (4 hours).

Query Params
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)

integer
Defaults to 1

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

Responses

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