Scan wallet token approvals for dangerous unlimited allowances and get revoke recommendations via x402.
What it does
The `/api/defi/approval-scanner` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence to autonomous AI agents. This specific endpoint analyzes on-chain token approvals for a given wallet address, identifying dangerous unlimited approvals and returning revoke recommendations. It is designed for AI agents operating in DeFi that need to assess or manage approval risk before executing transactions.
The endpoint accepts POST requests and is gated by the x402 payment protocol, settling in USDC on Base at $0.25 per call. Callers must include an x402 payment header; upon successful payment verification by the x402 facilitator, the endpoint processes the request and returns a JSON response. Free GET-based endpoint discovery is also available, providing schema hints and an `llm_usage_prompt` for agent integration.
DeFi Shield offers additional discovery mechanisms including a health endpoint (`/api/health`) listing all endpoints and pricing, an analytics endpoint (`/api/analytics`), and an A2A agent card at `/.well-known/agent-card.json`. The platform is at version 3.0.0 and covers 11 categories spanning DeFi intelligence, wallet intelligence, MEV/trading, NFT analysis, cross-chain data, safety/compliance, and more. No OpenAPI schema or detailed parameter documentation was found during crawl, so exact request/response shapes are inferred from the landing page examples.
Capabilities
Use cases
- —AI agents auditing a wallet's outstanding token approvals before executing a swap
- —Automated portfolio managers identifying and revoking dangerous unlimited allowances
- —Security bots monitoring wallets for newly granted high-risk approvals
- —DeFi dashboards surfacing approval hygiene scores to users
- —Agent workflows that revoke stale or risky approvals as part of wallet maintenance
Fit
Best for
- —Autonomous DeFi agents needing approval risk data before transactions
- —Wallet security auditing pipelines
- —AI agents that manage token allowances programmatically
Not for
- —Non-EVM chains or wallets without ERC-20 style approvals
- —Free or high-volume batch scanning (each call costs $0.25)
- —Users who need a UI-based approval management tool (this is an API-only endpoint)
Quick start
# Discover endpoint schema (free)
curl https://defi-shield-hazel.vercel.app/api/defi/approval-scanner
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/defi/approval-scanner \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0xYourWalletAddress"}'Example
Request
{
"address": "0x1234567890abcdef1234567890abcdef12345678"
}Endpoint
Quality
The endpoint is live (402 challenge captured) and the landing page provides clear pricing and a brief description, but no OpenAPI schema, detailed parameter docs, or example responses were found. The x402 challenge object was empty, providing no payment details beyond what the landing page states. Response shape is entirely inferred.
Warnings
- —No OpenAPI or JSON schema available for request/response validation
- —x402 challenge returned empty object — payment parameters (asset, amount, payTo) not captured in probe
- —No dedicated docs page found (404 at /docs)
- —Example response JSON is unknown — response shape is not documented anywhere in crawled material
Citations
- —The approval-scanner endpoint costs $0.25 per call and detects dangerous unlimited approvals with revoke recommendationshttps://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints across 11 categories, settling USDC via x402 on Basehttps://defi-shield-hazel.vercel.app
- —Platform is at version 3.0.0 with prices ranging $0.01–$2.50 per callhttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery is available via GET on each endpoint pathhttps://defi-shield-hazel.vercel.app