Skip to main content
POST

Authorizations

Authorization
string
header
required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Headers

Idempotency-Key
string

Alternative to the idempotency_key body field.

Body

application/json
from_asset
enum<string>
required
Available options:
USDT,
USDC,
BTC,
GOLD
to_asset
enum<string>
required
Available options:
USDT,
USDC,
BTC,
GOLD
amount
string
required

Amount in the source currency (6 decimals for USDT/USDC/GOLD, 8 for BTC).

idempotency_key
string

Response

Idempotency replay (original swap, never re-executed).

swap_id
string<uuid>
account_id
string<uuid>

Owning account. Lets org admins attribute each record in the org-wide view.

from_asset
enum<string>
Available options:
USDT,
USDC,
BTC,
GOLD
to_asset
enum<string>
Available options:
USDT,
USDC,
BTC,
GOLD
from_amount
string
to_amount
string
rate
string

Destination units per source unit (marked execution rate).

status
string
Example:

"completed"

idempotency_key
string
created_at
string<date-time>
idempotency_hit
boolean

Present on replays.

Last modified on July 19, 2026