API Reference

Create FX trade

posthttps://api-sandbox.circle.com/v1/exchange/trades

  • Reference
  • Playground

Creates a cross-currency trade

Body parameters
quoteId
string
Required

Unique system generated identifier for the entity.

idempotencyKey
string
Required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "data": {
3    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
4    "from": {
5      "amount": "3.14",
6      "currency": "USDC"
7    },
8    "to": {
9      "amount": "3.14",
10      "currency": "USDC"
11    },
12    "status": "pending",
13    "createDate": "2020-04-10T02:13:30.000Z",
14    "updateDate": "2020-04-10T02:13:30.000Z",
15    "quoteId": "b8627ae8-732b-4d25-b947-1df8f4007a29"
16  }
17}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.