UPupbit
Quotation

List Pair Trades

Retrieves recent trades for the specified pair.

get/v1/trades/ticks

Request

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

Query parameters

marketstring required

Trading pair code to query.

Example:SGD-BTC
tostring

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.

Example:134501
countinteger

Number of trade records to retrieve.

Up to 500 supported. Default: 1.

Example:500
cursorstring

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

days_agointeger

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.

Example:1

Response

List of trades

marketstring required

Trading pair code.

trade_date_utcstring required

Trade date (UTC-based).

[Format] yyyy-MM-dd

trade_time_utcstring required

Trade time (UTC-based).

[Format] HH:mm:ss

timestampinteger required

Milliseconds timestamp when the trade was executed.

trade_pricenumber double required

Most recent trade price.

trade_volumenumber double required

Most recent trade volume.

prev_closing_pricenumber double required

Previous day's closing price (UTC-based).

change_pricenumber 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_idinteger required

Unique identifier for the trade.

This field does not guarantee the sequence of trades.

Example response

[
  {
    "market": "SGD-BTC",
    "trade_date_utc": "2025-06-17",
    "trade_time_utc": "16:59:59",
    "timestamp": 1750749886904,
    "trade_price": 142340000,
    "trade_volume": 100000000,
    "prev_closing_price": 140908000,
    "change_price": 100000000,
    "ask_bid": "ASK",
    "sequential_id": 17501795992650000
  }
]

Changes