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

# List Second Candles

`GET /v1/candles/seconds`

## Request

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

Retrieves the list of candles per second.

## 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. URL encoding is required for spaces and special characters. [Example] 2025-06-24T04:56:53Z 2025-06-24 04:56:53 2025-06-24T13:56:53+08:00 Second candles only support data up to 3 months prior. An empty array is returned for older times.
- `count` integer: Number of candles to retrieve. Up to 200 candles are supported. Default: 1.

## Response `200`

List of candles

- Candle[]
  - `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.

## Other responses

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

## Changes

- **2026-11-03** `b16d646563b9`: 1 breaking
  - removed the required property `items/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/seconds/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)