Il tuo agente non può superare la spesa che hai impostato.
Imposta un'indennità per periodo e un limite per transazione per ogni agente nel dashboard. Il backend lo applica su ogni pagamento in uscita - il codice dell'agente non può aggirarlo.
Gli agenti autonomi commettono errori. Ritentano. Si ripetono. Vengono iniettati con prompt. Occasionalmente cercano di spendere denaro che non hai autorizzato.
Un permesso di spesa Blockchain0x è impostato dal proprietario nel dashboard e applicato dal backend, non dal codice dell'agente. Ogni pagamento in uscita viene controllato rispetto al permesso attivo prima che l'API lo accetti, quindi l'agente non può superare il limite anche se la sua logica ci prova. Il tuo codice può leggere il permesso tramite l'API per visualizzarlo o pianificare attorno ad esso, ma non può aumentarlo.
Quattro dimensioni. Impostato una volta. Applicato ovunque.
Indennità su un periodo
allowance_wei è il totale USDC (unità base) che l'agente può inviare in un intervallo di period_seconds. Il periodo è un giorno (86400), una settimana (604800) o 30 giorni (2592000).
Limite per transazione
per_tx_wei è il pagamento singolo in uscita più grande consentito. Ferma una chiamata errata dal trasferire più di quanto intendevi, indipendentemente dall'assegnazione del periodo.
Finestra di validità
start_at e end_at sono vincolati quando il permesso è attivo. Fuori dalla finestra non autorizza la spesa, quindi puoi pre-stabilire un budget o lasciare che uno scada da solo.
Revoca
revoked_at registra quando un permesso è stato disattivato dal dashboard. La revoca porta immediatamente l'assegnazione a zero per qualsiasi pagamento valutato dopo di essa.
La chiave dell'agente non può aumentare il proprio limite.
Crei, cambi e revoci i permessi di spesa nel dashboard. L'API li espone in sola lettura - non esiste un endpoint e nessun metodo SDK che modifica un permesso. Questo è il punto: se l'agente è iniettato di prompt o bloccato in un ciclo, non può ampliare la propria assegnazione, perché la credenziale che detiene non ha mai ricevuto quel potere.
Quando un pagamento supererebbe il permesso attivo, il backend lo rifiuta prima che qualcosa tocchi la catena. Nessun fondo si muove. Il tuo agente gestisce quel rifiuto come qualsiasi altra chiamata fallita e puoi vedere il tentativo nella dashboard in modo da poter ampliare il permesso se era legittimo.
Recupera il permesso attuale per visualizzarlo o pianificare attorno ad esso.
GET /v1/agents/{id}/spend-permissions restituisce i valori attivi. Usalo per mostrare un budget nella tua UI, o per consentire all'agente di controllare quanto spazio è rimasto prima di provare un pagamento.
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_secondsLa finestra a cui si applica l'assegnazione: 86400 (giorno), 604800 (settimana) o 2592000 (30 giorni).
start_at / end_atQuando il permesso è attivo. end_at è nullo per un permesso a tempo indeterminato.
revoked_atNulla mentre è attivo; un timestamp una volta revocato dal dashboard. Un permesso revocato non autorizza nulla.
Giorno, settimana o 30 giorni.
period_seconds prende uno dei tre valori. L'assegnazione si resetta quando il periodo scade; per_tx_wei si applica a ogni singolo pagamento indipendentemente dal periodo.
864001 giorno
6048001 settimana
259200030 giorni
Un permesso di spesa è un limite rigido, impostato una volta, applicato ovunque - non un flusso di approvazione per pagamento e non una conferma umana nel loop. Se hai bisogno di approvazioni o multi-firma, quello è un modello separato e più pesante; il permesso è il pavimento sempre attivo sotto di esso.