API ReferenceWallets
Get Wallet
Get wallet details including spending controls and transaction count.
Get Wallet
Returns detailed information about a specific wallet, including spending controls and transaction count.
Authentication
Requires X-API-Key header. You can only access wallets belonging to your API key.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Wallet UUID |
Request
curl http://localhost:4000/v1/wallets/WALLET_ID \
-H "X-API-Key: ak_your_key"Response (200)
{
"id": "wallet-uuid",
"name": "trading-wallet",
"addresses": {
"ethereum": "0x742d35Cc...",
"base": "0x742d35Cc...",
"solana": "7vYr3e..."
},
"spending_controls": {
"daily_limit_usd": 100,
"weekly_limit_usd": 500,
"monthly_limit_usd": 1000,
"per_tx_limit_usd": 50,
"allowed_addresses": [],
"allowed_domains": []
},
"transaction_count": 42,
"created_at": "2026-03-26T12:00:00.000Z"
}Response fields
| Field | Type | Description |
|---|---|---|
id | string | Wallet UUID |
name | string | Wallet name |
addresses | object | Chain addresses |
spending_controls | object or null | Current spending limits |
transaction_count | number | Total transactions for this wallet |
created_at | string | ISO 8601 timestamp |
Errors
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | Wallet not found or doesn't belong to your API key |