Token exposure and position aggregation for any wallet via x402-paid API on Base.
What it does
DeFi Shield is a suite of 69 paid API endpoints providing security intelligence for DeFi, wallets, protocols, NFTs, MEV, and cross-chain analysis. The `/api/wallet/exposure` endpoint specifically returns token exposure and position aggregation data for a given wallet address. It accepts POST requests and costs $0.50 per call, paid in USDC on Base via the x402 protocol.
The endpoint is part of the broader Wallet Intelligence category, which also includes wallet profiling, risk scoring, PnL breakdowns, copy-trading signals, and wallet clustering. All endpoints follow the same payment flow: the agent sends a POST with an x402 payment header, the facilitator verifies USDC payment on Base, the endpoint processes the request and returns JSON, and payment settles only on a successful response.
DeFi Shield supports free discovery via GET on any endpoint path, a health endpoint listing all endpoints and pricing, an A2A agent card at `/.well-known/agent-card.json`, and analytics at `/api/analytics`. No OpenAPI schema or detailed documentation page was found during crawling — the `/docs` path returns 404. Request/response schemas must be inferred from the landing page descriptions and quick-start examples.
Capabilities
Use cases
- —Autonomous agents assessing a wallet's token exposure before executing trades
- —Portfolio dashboards aggregating position data across tokens for a given address
- —Risk management systems checking concentration of holdings in a single wallet
- —Copy-trading bots evaluating target wallet positions before mirroring trades
- —DeFi agents performing pre-transaction due diligence on counterparty wallets
Fit
Best for
- —AI agents needing on-demand wallet exposure data with micropayments
- —DeFi automation workflows requiring position aggregation per wallet
- —Autonomous trading agents evaluating portfolio concentration risk
Not for
- —Free or high-volume bulk wallet scanning (each call costs $0.50)
- —Historical time-series portfolio tracking (endpoint appears to return current state)
- —Non-EVM chain wallet analysis (no evidence of non-EVM support)
Quick start
# Free discovery (GET returns endpoint info)
curl https://defi-shield-hazel.vercel.app/api/wallet/exposure
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/wallet/exposure \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x..."}'Example
Request
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Endpoint
Quality
The endpoint is live (402 challenge captured) and the landing page provides pricing and a brief description, but no OpenAPI schema, detailed docs, or response examples were found. The x402 challenge object was empty, so payment parameters (exact token, network, amount in base units) cannot be independently verified beyond the landing page claims.
Warnings
- —No OpenAPI or JSON schema available for request/response validation
- —The /docs path returns 404 — no detailed documentation exists
- —The x402 challenge object was empty (no payment parameters captured), so pricing is based solely on the landing page claim of $0.50
- —Response format is entirely unknown — no example response could be sourced
Citations
- —The /api/wallet/exposure endpoint provides token exposure and position aggregation at $0.50 per callhttps://defi-shield-hazel.vercel.app
- —Payment is in USDC via x402 protocol on Basehttps://defi-shield-hazel.vercel.app
- —DeFi Shield offers 69 paid API endpoints across 11 categorieshttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery is available via GET on any endpoint pathhttps://defi-shield-hazel.vercel.app
- —A2A discovery card available at /.well-known/agent-card.jsonhttps://defi-shield-hazel.vercel.app