GuidesAPI ReferenceRecipesAnnouncementsSupport
API Reference
GitHub

List Month Candles

get
https://{region}-api.upbit.com/v1/candles/months

Retrieves the list of candles per month.

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
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.
Retrieves candles that occurred before the specified time.
If not provided, the most recent candles based on the request time are returned by default.

Specify the time in ISO 8601 datetime format.
When making the actual request, ensure that any spaces or special characters in the datetime string are properly URL-encoded.

[Example]
2025-06-24T04:56:53Z (UTC)
2025-06-24 04:56:53 (UTC)
2025-06-24T13:56:53+08:00 (SGT)

integer
Defaults to 1

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

Responses

Updated 10 months ago

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

Updated 10 months ago