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 representing the market.

string

End time of the query period.
Candles earlier than the specified time will be retrieved.
If omitted, the latest candles are returned based on the request time.

Accepts ISO 8601 datetime format. You must perform URL encoding to ensure proper handling of 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 support queries only for up to the last 3 months from the request time. If you specify a time earlier than that, the response will return an empty array.

integer
Defaults to 1

Number of candles to retrieve.
Supports up to 200 candles.
Default: 1.

Responses

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