---
title: "List Pair Trades"
method: GET
path: "/v1/trades/ticks"
tags: ["Quotation"]
---

# List Pair Trades

`GET /v1/trades/ticks`

## Request

- Base URL: `https://{region}-api.upbit.com`
- URL: `https://{region}-api.upbit.com/v1/trades/ticks`
- Auth: none declared

Retrieves recent trades for the specified pair.

## Query parameters

- `market` string, required: Trading pair code to query.
- `to` 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: 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.

## Response `200`

List of trades

- Trade[]
  - `market` string, required: Trading pair code.
  - `trade_date_utc` string, required: Trade date (UTC-based). [Format] yyyy-MM-dd
  - `trade_time_utc` string, required: Trade time (UTC-based). [Format] HH:mm:ss
  - `timestamp` integer, required: Milliseconds timestamp when the trade was executed.
  - `trade_price` number, double, required: Most recent trade price.
  - `trade_volume` number, double, required: Most recent trade volume.
  - `prev_closing_price` number, double, required: Previous day's closing price (UTC-based).
  - `change_price` number, double, required: Price change from previous day's closing price. Calculated as "trade_price" - "prev_closing_price". - Positive(+): current price rose from previous closing - Negative(-): current price fell from previous closing - 0: no change from previous closing
  - `ask_bid` 'ASK' | 'BID', required: Trade direction — ASK (sell) or BID (buy).
  - `sequential_id` integer, required: Unique identifier for the trade. This field does not guarantee the sequence of trades.

## Other responses

- `400`: error object
- `404`: error object

## Changes

- **2026-11-03** `dd023742548b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upbit/apis/quotation-api/changes/v1/trades/ticks/get.md)

---

[API](https://skmtc.dev/upbit/apis/quotation-api.md) - [All operations](https://skmtc.dev/upbit/apis/quotation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/quotation-api/revisions/b16d646563b9?raw)
