API Reference

Get all trades

gethttps://api.circle.com/v1/exchange/stablefx/trades

  • Reference
  • Playground

Returns a paginated list of all trades.

Query parameters
type
string
Required

The type of trade.

status
string

The status of the trade to filter by.

pageSize
integer
1 to 200
Default is 50

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

from
date-time

Queries items created since the specified date-time (inclusive) in ISO 8601 format.

to
date-time

Queries items created before the specified date-time (inclusive) in ISO 8601 format.

settlementTransactionHash
string

Filter trades by settlement transaction hash.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": [
3    {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "contractTradeId": "24",
6      "status": "pending",
7      "rate": 0.915,
8      "from": {
9        "currency": "USDC",
10        "amount": ""
11      },
12      "to": {
13        "currency": "USDC",
14        "amount": ""
15      },
16      "createDate": "2023-01-01T12:04:05Z",
17      "updateDate": "2023-01-01T12:04:05Z",
18      "quoteId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
19      "settlementTransactionHash": "0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122"
20    }
21  ],
22  "pagination": {
23    "next": "",
24    "previous": ""
25  }
26}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.