billing

Withdraw to an address (code; a new address is confirmed by an email link)

Locked withdrawal intent to a saved address, or, for an address this account never used, a parked request that the emailed link (30 min) queues unchanged. New addresses are refused for 24 h after a password, 2FA or email change. API keys reach saved addresses only, without a code. No spendable credit while a transfer is pending.

post/api/v1/withdrawals

Request

Base URL: https://amplerun-api.spiry.org
URL: https://amplerun-api.spiry.org/api/v1/withdrawals
Auth: HTTP bearer

Headers

Idempotency-Keystring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

network'base'

Defaults to base.

addressstring required

amount_microstring required

Unsigned base-10 integer as string; never a float.

asset'USDC' | 'USDT'

Defaults to USDC.

labelstring

Saved with a new address.

codestring

siwe_messagestring

signaturestring

Example request

{
  "address": "0x1111111111111111111111111111111111111111",
  "amount_micro": "1"
}

Response

Queued, or waiting for the email link.

state'INTENT' | 'AWAITING_EMAIL_CONFIRMATION' required

withdrawal_idstring uuid

payout_idstring uuid

confirmation_idstring uuid

address_idstring uuid required

expires_atstring date-time

asset'USDC' | 'USDT' required

Example response

{
  "withdrawal_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "payout_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "confirmation_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "address_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "expires_at": "2026-09-25T12:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.