Wallet classification, balance, and activity timeline via x402-paid DeFi intelligence API
What it does
DeFi Shield's `/api/wallet/profile` endpoint provides wallet classification, balance information, and activity timeline data for blockchain addresses. It is one of 69 paid API endpoints in the DeFi Shield platform, which sells security intelligence to 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 profile including wallet type classification, balance data, and historical activity. It is priced at $0.50 per call. The broader DeFi Shield platform covers 11 categories including DeFi intelligence, wallet intelligence, safety & compliance, MEV & trading, NFT intelligence, cross-chain analysis, and more, with prices ranging from $0.01 to $2.50 per call.
Discovery is supported via a free GET request to the same path (returns endpoint metadata with an `llm_usage_prompt`), an agent card at `/.well-known/agent-card.json`, a health endpoint at `/api/health` listing all endpoints and pricing, and analytics at `/api/analytics`. The probe confirmed the endpoint is live, returning HTTP 402 on POST as expected for x402 endpoints. No OpenAPI schema or detailed documentation page was found; the main landing page serves as the primary reference.
Capabilities
Use cases
- —Classify an unknown wallet address before interacting with it in an autonomous agent workflow
- —Retrieve balance and activity data for risk assessment prior to a DeFi transaction
- —Build wallet dossiers for compliance or due-diligence pipelines
- —Feed wallet metadata into agent decision loops for copy-trading or trust scoring
Fit
Best for
- —AI agents needing on-chain wallet intelligence with pay-per-call pricing
- —Autonomous DeFi bots performing pre-transaction wallet checks
- —Developers building agent-to-agent trust and verification workflows
Not for
- —Bulk historical wallet analytics requiring millions of queries at low cost
- —Non-blockchain wallet or traditional banking account lookups
- —Users who need free or subscription-based pricing rather than per-call micropayments
Quick start
# Free discovery (returns endpoint metadata)
curl https://defi-shield-hazel.vercel.app/api/wallet/profile
# Paid request (requires x402 USDC payment on Base)
curl -X POST https://defi-shield-hazel.vercel.app/api/wallet/profile \
-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 (402 on POST), and the landing page provides a clear description and pricing ($0.50/call in USDC on Base). However, no OpenAPI schema, detailed docs, or example responses were found. The x402 challenge object was empty, so payment parameters (exact token address, network, facilitator) are inferred from the landing page rather than directly captured. Response shape is unknown.
Warnings
- —No OpenAPI or JSON schema available for request or response
- —x402 challenge body was empty — payment parameters (token, network, amount) not directly confirmed in probe
- —No dedicated documentation page found (docs, pricing, README all return 404)
- —Example response is inferred/unavailable; actual response structure is unknown
Citations
- —Wallet profile endpoint is priced at $0.50 per call and provides wallet classification, balance, and activity timelinehttps://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints across 11 categories, priced $0.01–$2.50, paid via USDC on Base using x402https://defi-shield-hazel.vercel.app
- —Free endpoint discovery is available via GET on each endpoint path, and agent discovery via /.well-known/agent-card.jsonhttps://defi-shield-hazel.vercel.app