Wallet trust scoring and risk classification via x402-paid API on Base
What it does
DeFi Shield's `/api/wallet/risk` endpoint provides wallet-level trust scoring, risk flags, and behavioral classification for Ethereum-compatible addresses. It is one of 69 paid endpoints in the DeFi Shield suite, a security intelligence platform designed for autonomous AI agents. Payment is handled per-request using USDC on Base via the x402 protocol.
The endpoint accepts POST requests with a wallet address and returns a trust score, risk flags, and a behavioral classification of the wallet. The listed price is $0.75 per call. The broader DeFi Shield platform covers 11 categories including DeFi intelligence, wallet intelligence, protocol risk, MEV/trading analysis, NFT intelligence, cross-chain data, safety/compliance checks, developer security, agent-to-agent trust, data infrastructure, and real-time monitoring.
The endpoint was confirmed live via a 402 challenge response, consistent with x402 protocol behavior. However, the 402 challenge body was empty (no payment details such as token address, amount, or network were included in the probe), and no OpenAPI schema or dedicated documentation page was found. Endpoint discovery is available via GET on the same path or through the `/api/health` and `/.well-known/agent-card.json` routes. Without detailed request/response schemas or example payloads in the crawled material, the exact input parameters and output structure must be inferred from the endpoint name and brief description.
Capabilities
Use cases
- —AI agents evaluating counterparty wallet risk before executing a DeFi transaction
- —Automated compliance workflows flagging high-risk wallets before interaction
- —Portfolio management bots screening wallets for suspicious behavioral patterns
- —Agent-to-agent trust verification by checking wallet risk profiles
- —DeFi protocol front-ends warning users about risky counterparties
Fit
Best for
- —Autonomous AI agents needing per-call wallet risk intelligence
- —DeFi applications requiring on-chain wallet trust scoring
- —Compliance pipelines that need programmatic wallet risk flags
Not for
- —Bulk historical wallet analytics requiring batch processing
- —Users who need free or subscription-based pricing rather than per-call micropayments
- —Non-blockchain wallet or traditional banking risk assessment
Quick start
# Discover endpoint details (free)
curl https://defi-shield-hazel.vercel.app/api/wallet/risk
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/wallet/risk \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x1234...abcd"}'Example
Request
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Endpoint
Quality
The endpoint is confirmed live via a 402 challenge, and the landing page provides a clear description and price ($0.75). However, the 402 challenge body was empty (no payment parameters captured), no OpenAPI schema exists, no docs page was found, and no example response is available. Request/response structure is inferred from the brief listing description.
Warnings
- —402 challenge body was empty — no payment parameters (token, amount, network) were captured in the probe
- —No OpenAPI or dedicated API documentation found (docs page returns 404)
- —Example response JSON is inferred/unavailable; actual output schema is unknown
- —Price of $0.75 per call is taken from the landing page listing but not confirmed in the 402 challenge
Citations
- —The /api/wallet/risk endpoint provides trust score, risk flags, and behavioral classification at $0.75 per callhttps://defi-shield-hazel.vercel.app
- —DeFi Shield offers 69 paid API endpoints across 11 categories, paid via USDC on Base using x402https://defi-shield-hazel.vercel.app
- —Endpoint discovery is available via GET on each endpoint path, /api/health, and /.well-known/agent-card.jsonhttps://defi-shield-hazel.vercel.app