billing

Save an address ahead of time (session; confirmed by email link)

2FA accounts also send their authenticator code. Needed before API-key withdrawals to a new address. Wallet-only accounts and API keys cannot add addresses.

post/api/v1/withdrawal-addresses

Request

Base URL: https://amplerun-api.spiry.org
URL: https://amplerun-api.spiry.org/api/v1/withdrawal-addresses
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'

addressstring required

labelstring

codestring

Example request

{
  "address": "0x1111111111111111111111111111111111111111"
}

Response

Link sent (or already saved).

state'AWAITING_EMAIL_CONFIRMATION' | 'SAVED' required

address_idstring uuid required

confirmation_idstring uuid

expires_atstring date-time

Example response

{
  "address_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40",
  "confirmation_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.