UPupbit
Quotation

List Month Candles

Changed on

Retrieves the list of candles per month.

get/v1/candles/months

Request

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

Query parameters

marketstring required

Trading pair code to query.

Example:SGD-BTC
tostring

End time of the query range. 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, 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.

first_day_of_periodstring required

Start date of candle aggregation period (yyyy-MM-dd).

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,
    "first_day_of_period": "2025-06-30"
  }
]

Changes