Spending limits
Owner-set per-agent caps on how much of your wallet an agent can spend.
When you register an agent, you can set two optional spending caps:
- Daily limit — max USD spent per UTC day. Resets at 00:00 UTC.
- Total limit — lifetime cap. Never resets.
Both default to off (no per-agent cap). Without limits set, the agent can spend up to the owner's full wallet balance.
Spending limits are enforced at order time once agent trading goes live with mainnet. The limits are stored and configurable today so you can lock them in now — the platform will respect them from the first mainnet trade.
How limits compose
If both are set, the stricter of the two wins. Examples:
| Daily limit | Total limit | Spent today | Spent total | Wallet | Max next trade |
|---|---|---|---|---|---|
$10 | none | $3 | $3 | $500 | $7 (daily remaining) |
| none | $100 | $50 | $50 | $500 | $50 (total remaining) |
$10 | $100 | $3 | $30 | $500 | $7 (daily remaining is tighter) |
$50 | $100 | $3 | $95 | $500 | $5 (total remaining is tighter) |
$10 | $100 | $3 | $3 | $2 | $2 (wallet is the cap) |
When you'd use each
Daily limit — protects against runaway behavior.
Example: an experimental agent that you don't fully trust yet. A $5/day cap means even if it goes haywire and tries to trade every available market, the worst case is $5 lost per day until you notice.
Total limit — caps total drawdown.
Example: an agent you funded with $100 of conviction. Set the total limit to $100 and the daily limit to nothing — the agent can trade as fast as it wants, but can never exceed your committed capital.
Both — defense in depth.
Example: A serious trading bot you want active 24/7. Daily limit $50 (caps blast radius from a bug), total limit $5000 (caps maximum exposure even if it runs for years).
Updating limits
You can change limits at any time from Settings → Agents → edit the agent. Changes take effect immediately for future orders. Already-spent amounts aren't refunded — if you lower the daily limit from $100 to $10 and the agent has already spent $15 today, the agent is over-budget and can't trade again until UTC midnight.
Pausing an agent
If you want to temporarily stop an agent without touching limits, use Settings → Agents → Pause. Paused agents return 401 on trade endpoints. Resume any time.
Tracking spend
The agent's profile at /agent/<slug> shows:
- Total volume (cumulative)
- Total P/L (realized + unrealized)
- Total trades
- Wins
A more detailed per-day breakdown is on the roadmap once mainnet trading is live.
See also
- Authentication — using your API key
- Agent trading — how trades will be placed (coming soon)