Je agent kan niet meer uitgeven dan je hebt ingesteld.
Stel een toelage per periode en een limiet per transactie in voor elke agent in het dashboard. De backend handhaaft dit op elke uitgaande betaling - de code van de agent kan dit niet omzeilen.
Autonome agenten maken fouten. Ze proberen opnieuw. Ze herhalen. Ze worden prompt-geïnjecteerd. Ze proberen af en toe geld uit te geven dat je niet hebt goedgekeurd.
Een Blockchain0x uitgaven toestemming is door de eigenaar ingesteld in het dashboard en gehandhaafd door de backend, niet door de code van de agent. Elke uitgaande betaling wordt gecontroleerd tegen de actieve toestemming voordat de API deze accepteert, zodat de agent de limiet niet kan overschrijden, zelfs niet als zijn logica dat probeert. Jouw code kan de toestemming via de API lezen om deze weer te geven of eromheen te plannen, maar kan deze niet verhogen.
Vier dimensies. Een keer ingesteld. Overal gehandhaafd.
Toelage over een periode
allowance_wei is het totale USDC (basis eenheden) dat de agent mag verzenden over één period_seconds venster. De periode is een dag (86400), een week (604800), of 30 dagen (2592000).
Per-transactie limiet
per_tx_wei is de grootste enkele uitgaande betaling die is toegestaan. Het voorkomt dat één foute oproep meer verplaatst dan je bedoelde, onafhankelijk van de periode-toelating.
Geldigheidsvenster
start_at en end_at zijn gebonden wanneer de toestemming actief is. Buiten het venster autoriseert het geen uitgaven, zodat je een budget vooraf kunt instellen of een laten verlopen.
Herroeping
revoked_at registreert wanneer een toestemming vanuit het dashboard is uitgeschakeld. Intrekking brengt de toelating onmiddellijk op nul voor elke betaling die erna wordt geëvalueerd.
De sleutel van de agent kan zijn eigen limiet niet verhogen.
Je creëert, wijzigt en trekt uitgavenpermissies in het dashboard in. De API stelt ze alleen-lezen beschikbaar - er is geen eindpunt en geen SDK-methode die een toestemming wijzigt. Dat is het hele punt: als de agent prompt-geïnjecteerd is of vastzit in een lus, kan hij zijn eigen toelaatbaarheid niet verbreden, omdat de referentie die hij heeft nooit die macht is verleend.
Wanneer een betaling de actieve toestemming zou overschrijden, wijst de backend deze af voordat iets de keten raakt. Er verplaatst geen geld. Je agent behandelt die afwijzing zoals elke andere mislukte oproep, en je ziet de poging in het dashboard zodat je de toestemming kunt verbreden als deze legitiem was.
Haal de huidige toestemming op om het weer te geven of eromheen te plannen.
GET /v1/agents/{id}/spend-permissions retourneert de live waarden. Gebruik het om een budget in je UI te tonen, of om de agent te laten controleren hoeveel ruimte er nog is voordat hij een betaling probeert.
curl https://api.blockchain0x.com/v1/agents/agt_123/spend-permissions \
-H "Authorization: Bearer $BLOCKCHAIN0X_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_secondsHet venster waarop de toelage van toepassing is: 86400 (dag), 604800 (week), of 2592000 (30 dagen).
start_at / end_atWanneer de toestemming actief is. end_at is null voor een open-ended toestemming.
revoked_atNull terwijl actief; een tijdstempel zodra het is ingetrokken vanuit het dashboard. Een ingetrokken toestemming autoriseert niets.
Dag, week of 30 dagen.
period_seconds neemt een van de drie waarden. De toelating wordt gereset wanneer de periode verstrijkt; per_tx_wei is van toepassing op elke enkele betaling ongeacht de periode.
864001 dag
6048001 week
259200030 dagen
Een bestedingsmachtiging is een harde limiet, eenmaal ingesteld, overal gehandhaafd - geen goedkeuringsworkflow per betaling en geen bevestiging door een mens in de lus. Als je goedkeuringen of multi-handtekeningen nodig hebt, is dat een apart, zwaarder patroon; de machtiging is de altijd actieve vloer eronder.