UPupbit
Quotation

List Second Candles

Changed on

Retrieves the list of candles per second.

get/v1/candles/seconds

Request

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

Query parameters

marketstring required

Trading pair code to query.

Example:SGD-BTC
tostring

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.

Example:2024-01-01T00:00:00
countinteger

Number of candles to retrieve.

Up to 200 candles are supported. 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.

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
  }
]

Changes