Recent Trades History

get

https://{region}-api.upbit.com/v1/trades/ticks

Retrieves recent trades for the specified pair.

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 'trade' group.

Query Params

market

string

required

Trading pair code representing the market.

string

End time of the query period(UTC).
This is an optional filter parameter to retrieve trade executed before a specific time window on the selected date.

Specify the time in either HHmmss or HH:mm:ss format.
The results are returned in reverse chronological order starting from the specified time.

[Example]
days_ago=1&to=130000 returns trades before 13:00:00 UTC of the previous day in descending order.

count

integer

Defaults to 1

Number of trades to retrieve.
Supports up to 500 trades. Default: 1.

cursor

integer

Cursor for pagination.
Enter the "sequential_id" from the API response into this field to continue retrieving trade history.
It returns up to "count" trades prior to the specified sequential_id.

days_ago

integer

Day offset between the trade date to query and the request time.
Trade history must be queried by specifying the trade date, and up to 7 days of history is supported (based on UTC).
Specify an integer between 1 and 7.
If omitted, the API returns the trades for the request date.
If set to 7, it returns trades executed 7 days before the request date, in reverse chronological order (latest first).

Responses

200List of trades

400error object

404error object