Skip to main content
GET
/
v1
/
exchange
/
stablefx
/
trades
Get all trades
curl --request GET \
  --url https://api-sandbox.circle.com/v1/exchange/stablefx/trades \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
      "contractTradeId": "24",
      "status": "pending",
      "rate": 0.915,
      "from": {
        "currency": "USDC",
        "amount": "<string>"
      },
      "to": {
        "currency": "USDC",
        "amount": "<string>"
      },
      "createDate": "2023-01-01T12:04:05Z",
      "updateDate": "2023-01-01T12:04:05Z",
      "quoteId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
      "settlementTransactionHash": "0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122"
    }
  ],
  "pagination": {
    "next": "<string>",
    "previous": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

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

​
status
enum<string>

The status of the trade to filter by.

Available options:
pending,
completed,
confirmed,
pending_settlement,
taker_funded,
maker_funded,
breaching,
breached
​
pageSize
integer
default: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.

Required range: 1 <= x <= 200
​
from
string<date-time>

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

Example:

"2023-01-01T12:04:05Z"

​
to
string<date-time>

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

Example:

"2023-01-01T12:04:05Z"

​
type
enum<string>
required

The type of trade.

Available options:
maker,
taker
​
settlementTransactionHash
string

Filter trades by settlement transaction hash.

Example:

"0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122"

Response

200 - application/json

Trade retrieved successfully

​
data
object[]
​
pagination
object

Pagination information for paged results