---
title: "List Year Candles"
method: GET
path: "/v1/candles/years"
tags: ["Quotation"]
---

# List Year Candles

`GET /v1/candles/years`

## Request

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

Retrieves the list of candles per year.

## Query parameters

- `market` string, required: Trading pair code to query.
- `to` string: End time of the query range. ISO 8601 format.
- `count` integer: Number of candles to retrieve. Up to 200, default: 1.

## Response `200`

List of candles

- CandlePeriod[]
  - `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.
  - `first_day_of_period` string, required: Start date of candle aggregation period (yyyy-MM-dd).

## 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/years/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)