Skip to main content
A stablecoin payout sends tokens from your balance to a wallet-rail beneficiary. Read Payouts first — idempotency, beneficiaries, error codes and how status behaves are shared with the fiat rail and are not repeated here.
Every example on this page is a signed request. $SIGNATURE is computed per request over a canonical string — see Authentication. Bearer tokens are not accepted.

​
Create a payout

​
string
required
Your own unique key for this payout. See Idempotency.
​
string
required
A wallet-rail beneficiary you own. The destination address is taken from the beneficiary — you do not send an address on the payout.
​
string
required
The ISO-4217 code of the currency to send — USD or EUR. Exactly three characters.
​
number
required
The amount to send.
​
string
Optional. Echoed back on the response and surfaced on the transaction.
Send the currency code, not the token symbol. USD sends the StableMint stablecoin for US dollars; USDSM is the token’s own symbol and is rejected — 'Currency' must be 3 characters in length. The response echoes back the code you sent.
There is no network or chain field. The chain is selected for you from the beneficiary. If you need the same token on a different chain, that is a bridge operation, not a payout parameter.

​
Response

201 Created on first submission, 200 OK on an idempotent replay.
The response mirrors the fiat rail, with destinationAddress in place of beneficiaryAccount.
status never implies on-chain finality at creation time. The payout is accepted before it is broadcast, and confirmation is established by watching the chain afterwards — not by the submission succeeding.Treat the payout as settled only when transaction.status.changed says so. An address typo cannot be undone once the transfer confirms, so verify the beneficiary, not the response.