Skip to main content
GET
GET /api/deals

Description

Returns up to 100 recent trades for one trading pair. Supports pagination and an optional date range.

Parameters

string
required
Pair code in {base}_{target} format, e.g. TRX_USDT.
string
Inclusive lower bound on dealDateUtc, ISO 8601 (UTC, no offset). Example: 2026-04-29T00:00:00.
string
Inclusive upper bound on dealDateUtc, ISO 8601 (UTC, no offset). Example: 2026-04-29T12:00:00.
integer
1-based page number. Defaults to 1.
integer
Number of trades per page. Maximum 100. Defaults to 100.

Response

Array of trade objects.
string (UUID)
required
Unique deal identifier.
string
required
Trade execution time, ISO 8601 in UTC with sub-millisecond precision (e.g. 2026-04-29T10:26:08.0053357Z).
string
required
Pair code, echoed back.
decimal
required
Trade size in base currency.
decimal
required
Trade price in target currency.
boolean
required
true if the taker bought (taker hit an ask). false if the taker sold (taker hit a bid).
boolean | null
true/false only on authenticated calls and only when the requesting user participated in the trade. null for public calls.

Example request

Example response

Notes

  • Trades are sorted by dealDateUtc descending (most recent first).
  • For aggregator-spec format with separate buy/sell arrays and integer trade IDs, see Aggregator Compatibility / historical_trades.
  • The id is a UUID in this endpoint and an integer in the aggregator-spec endpoint — they are different identifier spaces.