---
title: "List Minute Candles"
method: GET
path: "/v1/candles/minutes/{unit}"
tags: ["Quotation"]
---

# List Minute Candles

`GET /v1/candles/minutes/{unit}`

## Request

- Base URL: `https://{region}-api.upbit.com`
- URL: `https://{region}-api.upbit.com/v1/candles/minutes/{unit}`
- Auth: none declared

Retrieves the list of candles per minute.

## Path parameters

- `unit` 1 | 3 | 5 | 10 | 15 | 30 | 60 | 240, required: Candle unit in minutes. Specify the candle unit to retrieve. Up to 240 minutes (4 hours) is supported.

## Query parameters

- `market` string, required: Trading pair code to query.
- `to` 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
- `count` integer: Number of candles to retrieve. Up to 200 candles are supported. Default: 1.

## Response `200`

List of candles

- CandleMinute[]
  - `market` string, required: Trading pair code representing the market. [Example]: "SGD-BTC"
  - `candle_date_time_utc` string, required: Start time of the candle period in UTC. [Format]: yyyy-MM-dd'T'HH:mm:ss
  - `opening_price` number, double, required: The opening price of the candle, representing the first trading price during the candle period.
  - `high_price` number, double, required: The highest trading price, recorded during the candle period.
  - `low_price` number, double, required: The lowest trading price, recorded during the candle period.
  - `trade_price` number, double, required: The closing price of the candle, representing the last trading price during the candle period.
  - `timestamp` integer, required: The timestamp (in milliseconds) when the last tick of the candle was recorded.
  - `candle_acc_trade_price` number, double, required: The total trade amount (in the quoted currency) accumulated during the candle period.
  - `candle_acc_trade_volume` number, double, required: The total traded volume (in the base asset) accumulated during the candle period.
  - `unit` 1 | 3 | 5 | 10 | 15 | 30 | 60 | 240, required: Candle unit in minutes.

## Other responses

- `400`: error object
- `404`: error object

## Changes

- **2026-11-03** `b16d646563b9`: 1 breaking
  - removed the required property `items/allOf[#/components/schemas/Candle]/candle_date_time_kst` from the response with the `200` status
- **2026-11-03** `dd023742548b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upbit/apis/quotation-api/changes/v1/candles/minutes/:unit/get.md)

---

[API](https://skmtc.dev/upbit/apis/quotation-api.md) - [All operations](https://skmtc.dev/upbit/apis/quotation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/quotation-api/revisions/b16d646563b9?raw)