Skip to main content
POST
Create a Treasury conversion quote

What this endpoint does

Creates an exact, short-lived quote to convert between AUD and an enabled stablecoin in this tenant account.

When to use it

Create it after the user chooses a direction and source amount, then display its all-in rate, fee, available source balance, source debit, destination amount, network, and expiry for review. The console stores the returned quote ID internally.

Before you call

Use a secret API key with treasury:write. The pair and settlement network must be enabled and the source amount must meet current limits.

Money and balance effect

Creating a quote does not reserve or move money. The source wallet is checked and reserved only when the quote is accepted.

States and completion

A quote is usable until its expiry. If it expires or no longer passes acceptance checks, create a fresh quote rather than altering it.

Safe retries

Send a unique Idempotency-Key for the logical action. If the response is lost, retry the same payload with the same key; never create a new key merely because the first response timed out. Read Conversions and withdrawals for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Headers

Idempotency-Key
string
required

A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.

Required string length: 8 - 255

Body

application/json
sourceAsset
enum<string>
required
Available options:
AUD,
USDC,
USDT
destinationAsset
enum<string>
required
Available options:
AUD,
USDC,
USDT
settlementNetwork
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
sourceAmount
string
required
Pattern: ^\d+(\.\d+)?$
externalReference
string
required
Minimum string length: 1

Response

201 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
source
object
required
destination
object
required
settlementNetwork
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
rate
string
required
Pattern: ^\d+(\.\d+)?$
fee
object
required
sourceDebit
object
required
configurationId
string
required
Minimum string length: 1
expiresAt
string<date-time>
required
createdAt
string<date-time>
required