{"uid":"cap_N3ODqypILGSchpNAxltTY","slug":"approvals-wallet-244f73b5","name":"approvals-wallet","description":"Standing-state audit of a wallet's live ERC-20 token approvals. Indexes every approval the address ever granted, filters to those still live on-chain, flags unlimited, stale, scam-listed and canonical spenders, estimates money-at-risk, and returns a ranked revoke plan with ready calldata plus a 0-100 risk and allow, warn or block verdict. Risk indicators, not advice.","url":"https://api.agentstools.dev/approvals/wallet","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"limit":{"type":"integer","description":"Max distinct approvals to check (default/cap 40)"},"address":{"type":"string","description":"0x wallet address to audit (the owner)"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM network to audit (default base)"},"include_revoke_plan":{"type":"boolean","description":"Include the ordered revoke plan (default true)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3SMDriNsKFxXkSTG8_Hc4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits all live ERC-20 token approvals for a wallet address, flags risky spenders, estimates money-at-risk, and returns a ranked revoke plan with ready calldata and a risk verdict.","exampleAgentPrompt":"Can you audit my Ethereum wallet 0xAbC1234...5678 for live ERC-20 token approvals — flag any unlimited or scam-listed spenders, tell me how much is at risk, and give me a ranked revoke plan with calldata?","exampleUseCases":[{"title":"Post-phishing wallet security check","prompt":"I think I may have approved a scam contract recently — can you audit my Base wallet 0xDeF9876...4321 for all live token approvals, flag anything suspicious or unlimited, and tell me which ones to revoke first?"},{"title":"DeFi spring-cleaning revoke audit","prompt":"I want to clean up my old DeFi approvals on Ethereum — audit wallet 0xAaB1111...2222, show me any stale or unlimited approvals still live on-chain, estimate the money at risk, and give me the top 10 to revoke with calldata ready to go."},{"title":"Pre-transfer wallet risk assessment","prompt":"Before I move a large amount of funds into my Arbitrum wallet 0xCcD3333...4444, can you check it for any risky live ERC-20 approvals and give me an overall risk score and verdict so I know if it's safe?"}],"resultDescription":"Returns a list of live ERC-20 approvals granted by the wallet, each tagged with flags (unlimited, stale, scam-listed, canonical spender), an estimated money-at-risk figure, a 0–100 risk score, an allow/warn/block verdict, and — if requested — a ranked revoke plan with ready-to-submit calldata for each approval to revoke.","failureModes":["Invalid or malformed wallet address returns a validation error","Unsupported network value returns an enum validation error","Address with no approval history returns an empty approvals list","Limit parameter exceeding cap of 40 is silently capped","On-chain RPC failures may cause incomplete or stale approval data","Payment not included or insufficient returns HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, ready-to-act ERC-20 approval security audit for a specific wallet — especially when you want unlimited/scam/stale flagging, money-at-risk estimates, risk scoring with a verdicts, and ranked revoke calldata all in one call. Prefer it over generic blockchain explorers when you need actionable revoke plans rather than raw event logs, and over manual tools when the agent needs to automate wallet security workflows across Base, Ethereum, Arbitrum, Optimism, or Polygon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:20.182Z","isFirstParty":false}