Skip to main content
GET
Get a Treasury wallet conversion

What this endpoint does

Returns the quote, source reservation, fee, trade, physical settlement legs, destination credit, and current state for one conversion.

When to use it

Use it after a webhook, timeout, recovery event, or support question to determine which leg has completed and whether funds are spendable.

Before you call

Authenticate with treasury:read and pass a conversion ID owned by the same tenant account.

Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

States and completion

Destination funds are spendable only after the conversion settles and the destination wallet credit exists. Held or unknown legs require reconciliation, not a duplicate conversion.

Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an Idempotency-Key. Read Conversions and withdrawals for the complete workflow.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Response

200 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
quoteId
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
fee
object
required
sourceDebit
object
required
status
enum<string>
required
Available options:
accepted,
held,
submitted,
settled,
failed,
returned
settlementStatus
enum<string>
required
Available options:
source_settling,
trading,
destination_settling,
settled,
held
configurationId
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
reservation
object
required
nextAction
enum<string>
required
Available options:
none,
wait_for_settlement,
contact_support,
retry_new_request,
review_balance
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
providerReference
string
Minimum string length: 1
statusReason
string
Minimum string length: 1