Skip to main content
POST
Initiate a withdrawal

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Wallet ID

Body

application/json
requestId
string<uuid>
required

Client-generated idempotency key (UUID v4).

token
enum<string>
required

Stablecoin lane used to validate, fund, rebalance, and withdraw an allocation independently from other token lanes.

Available options:
usdc,
usdt
destinationChain
enum<string>
required

Destination chain for the withdrawal. Production chains are arbitrum, base, ethereum, polygon, and solana; sandbox accepts ethereum_sepolia and solana_devnet.

Available options:
arbitrum,
base,
ethereum,
ethereum_sepolia,
polygon,
solana,
solana_devnet
amountUsd
number<double>
required

Amount to withdraw in USD terms.

destinationAddress
string
required

On-chain destination address. Use an EVM hex address for EVM chains or a base58 address for solana.

Response

Withdrawal initiated (or existing withdrawal returned for idempotent retry)

id
string<uuid>
amountRequestedUsd
string | null

Requested withdrawal amount in USD as a formatted string.

amountPaidUsd
string | null

Completed payout amount in USD as a formatted string. Null until at least one payout completes.

feeUsd
string | null

Fee charged for the withdrawal as a formatted string.

destinationChain
enum<string>

Destination chain for the withdrawal.

Available options:
arbitrum,
base,
ethereum,
ethereum_sepolia,
polygon,
solana,
solana_devnet
destinationAddress
string
destinationToken
enum<string> | null
Available options:
usdc,
usdt
status
enum<string>

Simplified withdrawal status. partially_completed means at least one payout leg delivered value and at least one leg failed or was cancelled.

Available options:
processing,
completed,
partially_completed,
failed,
cancelled
legsCompleted
integer
legsTotal
integer
payoutLegs
object[]

Source-to-destination payout workflow legs.

failureReason
string | null

Human-readable reason for failure (only present when status is failed).

createdAt
string<date-time>
completedAt
string<date-time> | null