Skip to main content
GET
/
api
/
deals
GET /api/deals
curl --request GET \
  --url https://public-api.binibit.com/api/deals
{
  "id": {},
  "dealDateUtc": "<string>",
  "currencyPairCode": "<string>",
  "volume": 123,
  "price": 123,
  "isBuy": true,
  "isUserBuyer": {}
}

​
Description

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

​
Parameters

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

​
Response

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

​
Example request

curl "https://public-api.binibit.com/api/deals?currencyPairCode=TRX_USDT&pageSize=2"

​
Example response

[
  {
    "id": "97feb931-a168-4be9-b4bf-1b0736114c69",
    "dealDateUtc": "2026-04-29T10:26:08.0053357Z",
    "currencyPairCode": "TRX_USDT",
    "volume": 40.59,
    "price": 0.32250046,
    "isBuy": true,
    "isUserBuyer": null
  },
  {
    "id": "718cce29-b06b-4651-b53a-5c7b5692aa98",
    "dealDateUtc": "2026-04-29T10:18:48.4104029Z",
    "currencyPairCode": "TRX_USDT",
    "volume": 71.9,
    "price": 0.32022792,
    "isBuy": true,
    "isUserBuyer": null
  }
]

​
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.