get_agent_spend_limit
Read the spend limits
Returns the account owner's two limits and where the rolling 24-hour window stands: maxPerPaymentUsdc with the min, max, and default bounds it can be set within, maxPerDayUsdc, what has been spent and is left of the 24 hours, and maxPaymentNowUsdc, the most one payment may cost right now. The limit defaults to $1,000 and ranges from $1 to $50,000. It applies to every payment agentX402Pay makes, Laso routes and external url endpoints alike.
Check an amount against maxPaymentNowUsdc before attempting a payment rather than waiting to be refused. Compare the fee-inclusive total, since fees are added on top of the amount you request. Read-only to an agent: only the account owner can change the limit, from the dashboard. If a payment would exceed it, do not split it into smaller payments. Stop and tell your human.
Free.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | The highest value the owner can set. | |
| min | No | The lowest value the owner can set. | |
| default | No | The limit that applies when the owner has never set one. | |
| maxPerDayUsdc | No | The most everything the agent moves out may total across any rolling 24 hours: payments, wallet sends, and withdrawals together. | |
| nextReleaseAt | No | When the oldest outflow in the window stops counting, in ms since epoch. Null when nothing is counting. | |
| nextReleaseUsdc | No | How much allowance comes back at `nextReleaseAt`. Null when nothing is counting. | |
| spentLast24hUsdc | No | What has counted toward the 24-hour limit in the trailing 24 hours. | |
| maxPaymentNowUsdc | No | The most one payment may cost right now: the smaller of `maxPerPaymentUsdc` and `remainingTodayUsdc`. Check an amount against this, not against `maxPerPaymentUsdc` alone. | |
| maxPerPaymentUsdc | No | The most a single payment may total, fees included. | |
| remainingTodayUsdc | No | What is left of the 24-hour limit right now. |