Skip to main content
POST
Create a stablecoin destination

What this endpoint does

Saves and validates an asset/network/address destination for later stablecoin withdrawals from this tenant account.

When to use it

Create it after verifying the owner, exact network, address, and required tag or memo out of band.

Before you call

Use a secret API key with treasury:write. The asset/network must be enabled and the address must pass format validation and screening.

Money and balance effect

Creating a destination does not reserve or move wallet money.

States and completion

A successful response returns an active validated destination. A failed or held screening result cannot be used for withdrawal.

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
name
string
required
Required string length: 1 - 120
asset
enum<string>
required
Available options:
USDC,
USDT
network
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
address
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
tag
string
Minimum string length: 1

Response

201 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
name
string
required
Required string length: 1 - 120
asset
enum<string>
required
Available options:
USDC,
USDT
network
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
address
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
version
integer
required
Required range: x > 0
validationStatus
enum<string>
required
Available options:
validated
status
enum<string>
required
Available options:
active,
inactive
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
tag
string
Minimum string length: 1
deactivatedAt
string<date-time>