API ReferenceTransfers
Withdraw
Withdraw tokens from a wallet to an external address.
Withdraw
Send tokens from a managed wallet to an external destination. Spending controls are enforced before execution.
Authentication
Requires X-API-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Wallet UUID |
Request body
Request
curl -X POST http://localhost:4000/v1/wallets/WALLET_ID/withdraw \
-H "X-API-Key: ak_your_key" \
-H "Content-Type: application/json" \
-d '{
"to": "0xExternalAddress",
"amount": "50.00",
"currency": "USDC",
"chain": "base"
}'Response (200)
{
"transaction_id": "tx-uuid",
"tx_hash": "0xabc123...",
"from": "0x742d35Cc...",
"to": "0xExternalAddress",
"amount": "50.00",
"currency": "USDC",
"chain": "base",
"status": "confirmed",
"type": "withdrawal"
}Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_INPUT | Missing or invalid fields |
| 403 | varies | Spending control violation |
| 404 | NOT_FOUND | Wallet not found |
| 500 | WITHDRAWAL_FAILED | On-chain withdrawal failed |