v1

latestOpenAPI 3.1.02026-07-26261466.6 KB

Withdrawals

Request a withdrawal

Requests a withdrawal from the user's spendable balance. Two rails: bank (default) pays a saved destination by wire; address sends USDC on Base to destination_address. Both are processed manually by the Agentcard team, usually within 1-3 business days; the user is emailed when the request is received and again when it is sent. Open (not yet completed or rejected) requests count against the balance, so a user cannot over-request. Amounts range from $2.00 to $10,000.00.

post/api/v2/wallet/withdrawals

Request body

user_idstring required

The connected user's id.

amount_centsinteger required

Amount in USD cents, 200 to 1000000.

rail'bank' | 'address'

recipient_idstring

Bank rail: the saved destination to pay (wrec_...).

destination_addressstring

Address rail: a 0x-prefixed address on Base to receive USDC. Agentcard-managed addresses are rejected.

Response

The withdrawal, in requested.

object'withdrawal'

idstring

Withdrawal id (wd_...).

user_idstring

status'requested' | 'processing' | 'completed' | 'rejected'

rail'bank' | 'address'

bank pays a saved recipient by wire; address sends USDC on Base to the supplied address.

amount_centsinteger

destination_addressstring nullable

Set on the address rail: the Base address receiving USDC.

failure_codestring nullable

Set when rejected, e.g. rejected_by_ops.

completed_atstring date-time nullable

created_atstring date-time