List Minute Candles

get

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

Retrieves the list of candles per minute.

Path Params

unit

int32

enum

required

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

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.

Responses

Language

URL

Response

Choose an example:

application/json

200List of candles

400error object

404error object