List Pair Trades

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 to query.

string

End time within the query date range (UTC).
Optional parameter to retrieve trades within a specific time of the query date.

Accepts HHmmss or HH:mm:ss format. Trade list is returned in reverse chronological order from the specified time.

count

integer

Defaults to 1

Number of trade records to retrieve.

Up to 500 supported. Default: 1.

cursor

string

Cursor for pagination.
Enter the "sequential_id" from the response to retrieve the previous "count" trade records prior to that trade.

days_ago

integer

Day offset between the query date and the request date.
Must specify the target date; up to 7 days of history is supported (UTC-based).

Integer between 1 and 7. If omitted, returns trades for the current date. If 7, returns trades from 7 days ago in reverse chronological order.

Responses

200List of trades

400error object

404error object