API ReferenceSpending Controls
Get Spending Controls
Get spending controls and usage stats for a wallet.
Get Spending Controls
Returns the current spending control configuration and usage statistics for a wallet.
Authentication
Requires X-API-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Wallet UUID |
Request
curl http://localhost:4000/v1/wallets/WALLET_ID/controls \
-H "X-API-Key: ak_your_key"Response (200) -- Controls configured
{
"wallet_id": "wallet-uuid",
"controls": {
"daily_limit_usd": 100,
"weekly_limit_usd": 500,
"monthly_limit_usd": 1000,
"per_tx_limit_usd": 50,
"allowed_addresses": ["0xTrustedAddress"],
"allowed_domains": [],
"updated_at": "2026-03-26T12:00:00.000Z"
},
"usage_today": {
"spent_usd": 25.50,
"remaining_usd": 74.50
},
"usage_week": {
"spent_usd": 120.00,
"remaining_usd": 380.00
},
"usage_month": {
"spent_usd": 350.00,
"remaining_usd": 650.00
}
}Response (200) -- No controls
{
"wallet_id": "wallet-uuid",
"controls": null,
"message": "No spending controls configured. Use PUT to set them."
}Response fields
| Field | Type | Description |
|---|---|---|
wallet_id | string | Wallet UUID |
controls | object or null | Spending limits configuration |
controls.daily_limit_usd | number | Max USD per day (0 = unlimited) |
controls.weekly_limit_usd | number | Max USD per week |
controls.monthly_limit_usd | number | Max USD per month |
controls.per_tx_limit_usd | number | Max USD per transaction |
controls.allowed_addresses | string[] | Allowlisted recipient addresses |
controls.allowed_domains | string[] | Allowlisted domains |
usage_today | object | Today's spending stats |
usage_week | object | This week's spending stats |
usage_month | object | This month's spending stats |