get https://api.upbit.com/v1/candles/seconds
Support Range
The seconds candle API provides candles
within the last 3 months from the time of request. If this API returns an empty list or does not return the requested count, check thetoparameter.
Request Parameters
| Field | Description | Type |
|---|---|---|
| market | Market ID (ex. KRW-BTC) | String |
| to | End timestamp of the last candle (exclusive). Accepts ISO 8601 format: yyyy-MM-dd'T'HH:mm:ss'Z' or yyyy-MM-dd HH:mm:ss.Defaults to UTC, but a timezone offset can be specified (e.g. 2023-01-01T00:00:00+09:00 for KST).If omitted, the latest available candle will be returned. | String |
| count | Count of candles (LIMIT : 200) | Integer |
Response
Candles are generated only when trades occur during the corresponding time interval.
- For example, a 1-second candle with
candle_date_time=2024-08-31T22:25:00represents trades that occurred between2024-08-31T22:25:00(inclusive) and2024-08-31T22:25:01(exclusive).- If no trades occurred during that time, the 2024-08-31T22:25:00 candle will not be generated and will not appear in the response.
| Field | Description | Type |
|---|---|---|
| market | Market ID | String |
| candle_date_time_utc | Timestamp representing the start of the candle (in UTC) Format: yyyy-MM-dd'T'HH:mm:ss | String |
| candle_date_time_kst | Timestamp representing the start of the candle (in KST) Format: yyyy-MM-dd'T'HH:mm:ss | String |
| opening_price | Open price | Double |
| high_price | High price | Double |
| low_price | Low price | Double |
| trade_price | Close price | Double |
| timestamp | Last trade timestamp | Long |
| candle_acc_trade_price | Cumulative trade price | Double |
| candle_acc_trade_volume | Cumulative trade volume | Double |