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
C-LibcurlClojure-clj-httpC#-HttpClientC#-RestSharpGo-NewRequestHTTP-HTTP/1.1Java-AsyncHttpJava-java.net.httpJava-OkHttpJava-UnirestJavaScript-AxiosJavaScript-fetchJavaScript-jQueryJavaScript-XMLHttpRequestJSON-Native JSONKotlin-okhttpNode-AxiosNode-FetchNode-HTTPNode-RequestNode-UnirestObjective-C-NSURLSessionOCaml-CoHTTPPHP-cURLPHP-GuzzlePHP-HTTP v1PHP-HTTP v2Powershell-Invoke-RestMethodPowershell-Invoke-WebRequestPython-RequestsR-httrRuby-net::httpShell-cURLShell-HTTPieShell-WgetSwift-URLSession
ResponseChoose an example
200400401404
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.
Developer TermsService TermsPrivacy PolicyAcceptable UseYour Privacy ChoicesYour Privacy ChoicesCookie Policy