UPupbit
Quotation

List Day Candles

Changed on

Retrieves the list of candles per day.

get/v1/candles/days

Request

  • Base URL
    https://{region}-api.upbit.com
  • URL
    https://{region}-api.upbit.com/v1/candles/days
  • Auth
    none declared

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

prev_closing_pricenumber double required

Previous day's closing price (UTC-based).

change_pricenumber double required

Price change = trade_price - prev_closing_price.

change_ratenumber double required

Change rate = (trade_price - prev_closing_price) / prev_closing_price.

converted_trade_pricenumber double

Closing price converted per converting_price_unit. Null for non-digital asset markets.

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,
    "prev_closing_price": 147996000,
    "change_price": -2237000,
    "change_rate": -0.0151152734,
    "converted_trade_price": 148601000
  }
]

Changes

  • b16d646563b9Revision changes
    • breaking

      removed the required property ///// from the response with the status

    • warning

      deleted the query request parameter converting_price_unit

  • dd023742548bRevision changes
    • info

      endpoint added