UPupbit
Quotation

List Minute Candles

Changed on

Retrieves the list of candles per minute.

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

Path parameters

unit1 | 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.

Example:15

Query parameters

marketstring required

Trading pair code to query.

Example:SGD-BTC
tostring

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

Example:2024-01-01T00:00:00
countinteger

Number of candles to retrieve.

Up to 200 candles are supported. Default: 1.

Example:200

Response

List of candles

marketstring required

Trading pair code representing the market.

candle_date_time_utcstring required

Start time of the candle period in UTC.

opening_pricenumber double required

The opening price of the candle, representing the first trading price during the candle period.

high_pricenumber double required

The highest trading price, recorded during the candle period.

low_pricenumber double required

The lowest trading price, recorded during the candle period.

trade_pricenumber double required

The closing price of the candle, representing the last trading price during the candle period.

timestampinteger required

The timestamp (in milliseconds) when the last tick of the candle was recorded.

candle_acc_trade_pricenumber double required

The total trade amount (in the quoted currency) accumulated during the candle period.

candle_acc_trade_volumenumber double required

The total traded volume (in the base asset) accumulated during the candle period.

unit1 | 3 | 5 | 10 | 15 | 30 | 60 | 240 required

Candle unit in minutes.

Example response

[
  {
    "market": "SGD-BTC",
    "candle_date_time_utc": "2025-06-23T14:29:59",
    "opening_price": 142340000,
    "high_price": 142340000,
    "low_price": 142340000,
    "trade_price": 142340000,
    "timestamp": 1750688999123,
    "candle_acc_trade_price": 185042,
    "candle_acc_trade_volume": 0.0013,
    "unit": 1
  }
]

Changes