Skip to main content
POST
CLI

Authorizations

Authorization
string
header
required

API Key in Bearer format (e.g., Bearer sk_test_...)

Headers

X-API-Key
string

API key

Body

application/json
quoteId
string
required

ID of a PENDING firm quote returned by POST /v1/fx/quotes.

Example:

"quote_abc123"

payoutDestination
object
required

Response

Trade created. Deposit funds within depositDeadline.

tradeId
string
required
Example:

"tfr_abc123"

status
enum<string>
required

Lifecycle status. PENDING_WALLET_APPROVAL means accept succeeded but the source wallet is still being verified — depositInstructions is omitted until verification clears and the trade transitions to AWAITING_DEPOSIT (delivered via the fx_trade.deposit_instructions_ready webhook).

Available options:
PENDING_WALLET_APPROVAL,
AWAITING_DEPOSIT,
PROCESSING,
COMPLETED,
FAILED,
CANCELLED,
AUTO_CANCELLED,
REFUNDED
Example:

"AWAITING_DEPOSIT"

referenceRate
string

Independent reference rate used to price this trade, expressed as destination major units per source major unit. Present for benchmark-priced trades.

Example:

"1.158691536019208779"

referenceRateAsOf
string

Timestamp of the independent reference rate used to price this trade (ISO 8601).

Example:

"2026-09-02T18:30:04.000Z"

referenceProvider
enum<string>

Independent market that published referenceRate. Present when referenceRate is present.

Available options:
XE
Example:

"XE"

depositInstructions
object

On-chain deposit instructions for crypto-source trades. Present once the trade reaches AWAITING_DEPOSIT. Omitted while status=PENDING_WALLET_APPROVAL and for fiat-source trades (which return fundingInstructions instead).

fundingInstructions
object

Bank funding instructions for fiat-source trades. Present once the trade reaches AWAITING_DEPOSIT on fiat-source pairs (USD / EUR / GBP source) — the customer wires from their bank to the account in this object using reference as the wire memo. Mutually exclusive with depositInstructions.

depositDeadline
string

Customer-facing deposit deadline (ISO 8601). Present when either depositInstructions or fundingInstructions is present.

Example:

"2026-05-26T19:54:00.000Z"

screeningDeadline
string

Deadline by which source-wallet verification must complete (ISO 8601). Present only when status=PENDING_WALLET_APPROVAL. If verification has not cleared by this point the trade transitions to FAILED.

Example:

"2026-05-26T19:47:00.000Z"