Define limits before delegating payment access.
Review how payment limits are evaluated and which paths are covered by enforcement. Set an allowance per period and a per-transaction cap on each agent in the dashboard.
自主代理会犯错误。它们会重试。它们会循环。它们会被提示注入。它们偶尔会试图花费您未授权的资金。
An AgentCredia spend permission is owner-set in the dashboard and enforced by the backend, not by the agent's code. Every outbound payment is checked against the active permission before the API accepts it, so a payment above the limit is rejected even if the agent's logic tries to send it. Your code can read the permission over the API to display it or plan around it, but it cannot raise it.
四个维度。设置一次。到处强制执行。
每周期津贴
allowance_wei 是代理在一个 period_seconds 窗口中可以发送的总 USDC（基本单位）。该周期为一天（86400），一周（604800）或 30 天（2592000）。
每笔交易上限
per_tx_wei 是允许的最大单笔出站支付。它阻止一次错误调用移动超过您所期望的金额，与期间限额无关。
有效性窗口
start_at 和 end_at 在权限生效时绑定。在窗口外，它不授权支出，因此您可以预先设置预算或让其自行到期。
撤销
revoked_at 记录何时从仪表板关闭权限。撤销立即将限额降至零，适用于其后评估的任何支付。
代理的密钥无法提高其自身限制。
您可以在仪表板中创建、修改和撤销支出权限。API 以只读方式公开它们 - 没有端点，也没有 SDK 方法可以更改权限。这就是重点：如果代理被注入提示或陷入循环，它无法扩大自己的津贴，因为它持有的凭证从未被授予该权限。
当支付超过活动权限时，后端在任何操作触及链之前拒绝它。没有资金移动。您的代理像处理其他失败调用一样处理该拒绝，您可以在仪表板中看到该尝试，以便在其合法时扩大权限。
获取当前权限以显示或围绕它进行计划。
GET /v1/agents/{id}/spend-permissions返回实时值。使用它在您的UI中显示预算，或让代理检查在尝试支付之前剩余多少空间。
curl https://api.agentcredia.com/v1/agents/agt_123/spend-permissions \
-H "Authorization: Bearer $AGENTCREDIA_API_KEY"{
"allowance_wei": "5000000",
"per_tx_wei": "1000000",
"period_seconds": 86400,
"start_at": "2026-05-15T00:00:00Z",
"end_at": null,
"revoked_at": null
}allowance_weiTotal spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.
per_tx_weiLargest single payment allowed, in base units. "1000000" is 1 USDC. A payment over this is rejected even if the period allowance has room.
period_seconds津贴适用的窗口：86400（天）、604800（周）或 2592000（30 天）。
start_at / end_at当权限处于活动状态时。end_at 对于开放式权限为 null。
revoked_at在活动时为Null；从仪表板撤销后为时间戳。被撤销的权限不授权任何内容。
天、周或 30 天。
period_seconds 取三个值之一。当周期滚动时，限额重置；per_tx_wei 适用于每一笔支付，无论周期如何。
864001 天
6048001 周
259200030天
支出权限是一个硬限制，一次设置，在任何地方强制执行 - 不是每笔付款的批准工作流，也不是人类确认。如果您需要批准或多重签名，那是一个单独的、更复杂的模式；权限是始终存在的底线。