{"name":"Spend firewall: allow, hold or block an agent payment before it happens","description":"Spend firewall for AI agents with a wallet or card, called before every payment: checks your rules (per-payment cap, daily budget reserved atomically, allow/block lists, chains, tokens, approval threshold, new merchants, kill switch), the merchant or checkout URL (preflight), the text that triggered the payment (input-guard: hidden instructions) and non-USDC tokens (token-risk). Returns allow, hold or block with reasons; with a stored policy the amount is reserved until confirm or release.","category":"crypto-trading-signals","paid":{"method":"POST","endpoint":"https://earn.oroboros-design.com/agenten/signal/shield-check","short":"https://earn.oroboros-design.com/shield/check","body":{"payment":{"amount_usd":12.5,"merchant_url":"https://angel.oroboros-design.com/agenten/signal/stealth-read","chain":"base","asset":"USDC"},"trigger":{"text":"Please buy the market data report for the client."},"policy":{"max_per_payment_usd":50,"allowed_chains":["base"],"hold_above_usd":25}},"schema":{"type":"object","properties":{"payment":{"type":"object","properties":{"amount_usd":{"type":"number","exclusiveMinimum":0},"merchant_url":{"type":"string","pattern":"^https://","maxLength":2048,"description":"shop, checkout or payment link, API or x402 endpoint the agent is about to pay"},"pay_to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"recipient address, when there is no URL"},"chain":{"type":"string","description":"base, ethereum or eip155:<id>"},"asset":{"type":"string","description":"USDC or a token address"},"method":{"type":"string","enum":["GET","POST"]}},"required":["amount_usd"]},"trigger":{"type":"object","description":"the instruction, message or page that made the agent want to pay","properties":{"text":{"type":"string","maxLength":100000},"url":{"type":"string","pattern":"^https://","maxLength":2048}}},"policy":{"type":"object","description":"inline rules (stateless); for a daily budget and remembered merchants store them with POST /shield/policy and send policy_id","properties":{"max_per_payment_usd":{"type":"number"},"allow_merchants":{"type":"array","items":{"type":"string"}},"block_merchants":{"type":"array","items":{"type":"string"}},"allowed_chains":{"type":"array","items":{"type":"string"}},"allowed_assets":{"type":"array","items":{"type":"string"}},"hold_above_usd":{"type":"number"},"kill":{"type":"boolean"}}},"policy_id":{"type":"string","pattern":"^pol_[A-Za-z0-9]{8,40}$","description":"a stored policy (needs your key as X-Bundle-Token or bundle_token)"},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"same key = same reservation, never reserved twice"},"hold_seconds":{"type":"integer","minimum":60,"maximum":3600,"description":"how long an allowed amount stays reserved (default 900)"}},"required":["payment"]},"pay":"x402 v2 (PAYMENT-SIGNATURE) or USDC transfer + header X-PAYMENT-TX or X-Bundle-Token"},"price_usd":{"unknown":"0.02","known":"0.02","trusted":"0.014"},"bundle_calls":1,"bundle":{"default":true,"proposal":{"calls":50000,"price_usd":"299.00","per_call_usd":"0.00598","valid_days":365,"role":"proposal","this_call_with_pack_usd":"0.00598","save_pct":70,"break_even_calls":14950,"buy":"POST https://earn.oroboros-design.com/agenten/signal/pack {\"calls\":50000}"},"anchor":{"calls":5000,"price_usd":"39.00","per_call_usd":"0.0078","valid_days":90,"role":"anchor","this_call_with_pack_usd":"0.0078","save_pct":61,"break_even_calls":1950,"buy":"POST https://earn.oroboros-design.com/agenten/signal/pack {\"calls\":5000}","card":"https://earn.oroboros-design.com/buy?calls=5000"},"tiers":[{"calls":500,"price_usd":"5.00","per_call_usd":"0.01","valid_days":30,"role":"entry","this_call_with_pack_usd":"0.01","save_pct":50,"break_even_calls":250,"buy":"POST https://earn.oroboros-design.com/agenten/signal/pack {\"calls\":500}","card":"https://earn.oroboros-design.com/buy?calls=500"},{"calls":5000,"price_usd":"39.00","per_call_usd":"0.0078","valid_days":90,"role":"anchor","this_call_with_pack_usd":"0.0078","save_pct":61,"break_even_calls":1950,"buy":"POST https://earn.oroboros-design.com/agenten/signal/pack {\"calls\":5000}","card":"https://earn.oroboros-design.com/buy?calls=5000"},{"calls":50000,"price_usd":"299.00","per_call_usd":"0.00598","valid_days":365,"role":"proposal","this_call_with_pack_usd":"0.00598","save_pct":70,"break_even_calls":14950,"buy":"POST https://earn.oroboros-design.com/agenten/signal/pack {\"calls\":50000}"}],"compare":{"this_call_usd":"0.02","with_pack_usd":"0.00598","pack_calls_used":1,"save_pct":70},"covers":"every TradeSignal surface; fresh=true counts 5","use":"header X-Bundle-Token: <token> on https://earn.oroboros-design.com/agenten/signal and every surface — no per-call signing","decision":{"rule":"buy the smallest tier whose break_even_calls you expect to exceed within its valid_days; otherwise pay per call (accepts[0])","needs_user_approval":true,"why":"every pack is above the 1 USD default per-payment cap of x402 clients: hand the card link to your user, or raise the cap for this one purchase","card":"https://earn.oroboros-design.com/buy?calls=5000"}},"payTo":{"network":"eip155:8453","asset":"USDC","address":"0x0CAc7D3c89be4f478E4c8f713C0D3D2D0954678D"},"returns":{"asof":"2026-11-16T00:00:00Z","decision":"hold","reasons":["[hold] trigger: input-guard: caution (payment_request)"],"payment":{"amount_usd":12.5,"merchant":"shop.example.com","chain":"base","asset":"usdc"},"merchant_check":{"verdict":"pay","risk_score":12},"trigger_check":{"verdict":"caution","score":25},"token_check":null,"reservation":null,"budget":null,"advice":"Do not pay yet. Ask a human to approve, or fix the reason and check again."},"never_charged":["400 bad body or unknown symbol","429 slot full","503 data source unavailable"],"after":"pay, then POST /shield/confirm with the reservation_id (or /shield/release if you did not pay)","docs":"https://earn.oroboros-design.com/agenten/signal/agent.md","feed":"https://earn.oroboros-design.com/agenten/signal","disclaimer":"Data, not investment advice."}