Get all trades
Returns a cursor-paginated list of all trades, newest first by default.
Pagination is navigated through the Link response header, not the response body. Follow the
next relation to walk the collection and stop when it is no longer returned.
Authorizations
Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request.
Query Parameters
The status of the trade to filter by.
pending, complete, confirmed, pending_settlement, taker_funded, maker_funded, refunded, breaching, breached Filter trades by one or more asset currencies.
1Currency code
USDC, EURC Filter trades by a single trade ID or ID prefix.
1 - 36Filter trades by one or more trade IDs.
1Limits the number of items to be returned.
Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used.
If avoided, the collection will determine the page size itself.
1 <= x <= 200Cursor -- returns the trades immediately following the trade with this id in the current
sort order. With the default sortOrder=desc this advances towards older trades.
Take the value from the pageAfter parameter of the next link in the Link response
header. Cannot be combined with pageBefore.
"04a4892d-eef4-4df9-a5a4-4ccfc43497d6"
Cursor -- returns the trades immediately preceding the trade with this id in the current
sort order. With the default sortOrder=desc this navigates back towards newer trades.
Take the value from the pageBefore parameter of the prev link in the Link response
header. Cannot be combined with pageAfter.
"04a4892d-eef4-4df9-a5a4-4ccfc43497d6"
Queries items created since the specified date-time (inclusive) in ISO 8601 format.
"2023-01-01T12:04:05Z"
Queries items created before the specified date-time (inclusive) in ISO 8601 format.
"2023-01-01T12:04:05Z"
The type of trade. The type of trader.
maker, taker Filter trades by settlement transaction hash.
^0x[a-fA-F0-9]{64}$"0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122"
Sort order for trades by creation date. Defaults to desc (newest first).
asc, desc Response
Trade retrieved successfully