GET /api/deals
Market Data
GET /api/deals
Recent completed trades for a single trading pair.
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
dealDateUtcdescending (most recent first). - For aggregator-spec format with separate
buy/sellarrays and integer trade IDs, see Aggregator Compatibility / historical_trades. - The
idis a UUID in this endpoint and an integer in the aggregator-spec endpoint — they are different identifier spaces.
