List Second Candles

Retrieves the list of candles per second.

Note on 1-Second Candles (Tick Candles) Data Retention
The 1-second candle API provides data for up to 3 months, based on the time of the request. If you request data beyond this period, the response may return an empty list or fewer items than the requested count. To check the available period, use the to parameter when making the query.
Candles are created only when trades occur within the given time interval.
If no trades occur between the start and end time of a candle, it will not be created and therefore will not appear in the API response. For example, a 1-Second candle with candle_date_time = 2024-08-31T22:25:00 will not be created if no trades occur between 22:25:00 (inclusive) and 22:25:01 (exclusive).
Check the proper endpoint based on your region.
The examples in this page is written using Singapore fiat code(SGD). Set the quote currency to match your region. The base_url differs by country/region. Make sure to specify the correct region value for your environment.

- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com

Version Date Changes
v1.1.8 2024-10-30 Addition of List Second Candles
Rate Limit
Up to 10 calls per second are allowed. This is measured on an IP basis and request counts are shared within the exchange 'candle' group.
Query Params
string
required

Trading pair code to query.

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.

integer
Defaults to 1

Number of candles to retrieve.

Up to 200 candles are supported. Default: 1.

Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/json