API Reference

Wallets

API Overview

Health

Webhook Subscriptions

Configurations

Monitor Tokens

Developer Account

Faucet

Developer-Controlled Wallets

Wallet Sets

Wallets

Signing

Transactions

Token Lookup

Modular Wallets

Transfers

UserOps

Wallets

User-Controlled Wallets

Social/ Email Authentication

PIN Authentication

Users

Wallets

Transactions

Token Lookup

Signing

Compliance Engine

Address Screening

Create a trade

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

Reference
Playground

Accepts a quote and creates a trade.

Body parameters

quoteId

string

Required

System-generated unique identifier of the resource.

idempotencyKey

string

Required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests. To create a UUIDv4 go to uuidgenerator.net. If the same key is reused, it will be treated as the same request and the original response will be returned.

Response

200

Response Body

object

string

System-generated unique identifier of the resource.

contractTradeId

string

The ID of the trade on the contract.

status

string

Allowed valuespendingcompletedconfirmedpending_settlementtaker_fundedmaker_fundedbreachingbreached

rate

number

Exchange rate for the quote

from

object

Currency and amount details for a foreign exchange transaction

Show 2 properties

currency

string

Required

Currency code

Allowed valuesUSDCEURC

amount

string

Amount of currency, formatted as a string with up to two decimal places.

object

Currency and amount details for a foreign exchange transaction

Show 2 properties

currency

string

Required

Currency code

Allowed valuesUSDCEURC

amount

string

Amount of currency, formatted as a string with up to two decimal places.

createDate

string

Date and time when the resource was created

updateDate

string

Date and time when the resource was last updated

quoteId

string

System-generated unique identifier of the resource.

settlementTransactionHash

string

The hash of the settlement transaction on-chain.

RequestChoose a language

ResponseChoose an example

1{
2  "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
3  "contractTradeId": "24",
4  "status": "pending",
5  "rate": 0.915,
6  "from": {
7    "currency": "USDC",
8    "amount": ""
9  },
10  "to": {
11    "currency": "USDC",
12    "amount": ""
13  },
14  "createDate": "2023-01-01T12:04:05Z",
15  "updateDate": "2023-01-01T12:04:05Z",
16  "quoteId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
17  "settlementTransactionHash": "0xf97c6a87511583d5c7e8e72f8e1fe38bfd24350edda78fddbe67125f3cf0a122"
18}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy