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

200CreateFxTradeResponse

Response Body

object

data

object

Show 7 properties

string

Unique system generated identifier for the entity.

from

object

Show 2 properties

amount

string

Required

Magnitude of the amount, in units of the currency, with a ..

currency

string

Required

Allowed valuesUSDCEURCMXNBRL

object

Show 2 properties

amount

string

Required

Magnitude of the amount, in units of the currency, with a ..

currency

string

Required

Allowed valuesUSDCEURCMXNBRL

status

string

Status of the trade.

Allowed valuespendingconfirmedfailedcompletepending_settlement

createDate

string

ISO-8601 UTC date/time format.

updateDate

string

ISO-8601 UTC date/time format.

quoteId

string

Unique system generated identifier for the entity.

400BadRequest

401NotAuthorized

404NotFound

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?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy