Protocol risk scoring via TVL trend analysis, paid per call with USDC on Base via x402.
What it does
DeFi Shield's `/api/protocol/risk` endpoint provides protocol-level risk assessment based on TVL (Total Value Locked) trend analysis. It is one of 69 paid API endpoints offered by DeFi Shield, a security intelligence platform designed for autonomous AI agents. The endpoint accepts POST requests and costs $0.50 per call, settled in USDC on Base via the x402 payment protocol.
The broader DeFi Shield platform spans 11 categories including DeFi intelligence, wallet intelligence, protocol intelligence, MEV & trading, NFT intelligence, cross-chain analysis, safety & compliance, developer security, agent-to-agent trust, data infrastructure, and real-time monitoring. Each endpoint supports free GET-based discovery (returning an LLM usage prompt) and paid POST requests requiring an x402 payment header. The platform advertises an agent card at `/.well-known/agent-card.json` and a health/discovery endpoint at `/api/health`.
The specific `/api/protocol/risk` endpoint sits within the Protocol Intelligence category alongside related endpoints for TVL decomposition, governance risk, protocol comparison, emission modeling, oracle risk, and bridge risk. No OpenAPI schema or detailed request/response documentation was found during crawling — the docs page returns 404. The endpoint returned a 402 status on POST probe, confirming it is live and expecting x402 payment, though the challenge body was empty, which limits confidence in the exact payment parameters.
Capabilities
Use cases
- —AI agents evaluating protocol safety before allocating funds
- —Automated portfolio managers screening DeFi protocols by risk level
- —Due diligence tooling that checks TVL trends for protocol health
- —Agent workflows comparing multiple protocols before yield farming
Fit
Best for
- —Autonomous AI agents needing per-call DeFi risk intelligence
- —Developers building automated DeFi safety pipelines
- —Agents that settle micropayments in USDC on Base via x402
Not for
- —Users needing free or subscription-based risk data without per-call crypto payments
- —Real-time streaming risk monitoring (this is a request-response endpoint)
- —Non-DeFi protocol risk assessment
Quick start
# Discover endpoint details (free)
curl https://defi-shield-hazel.vercel.app/api/protocol/risk
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/protocol/risk \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"protocol": "aave"}'Example
Request
{
"protocol": "aave"
}Endpoint
Quality
The endpoint is confirmed live (402 on POST), and the landing page provides pricing ($0.50) and a brief description. However, no OpenAPI schema, detailed docs, request/response examples, or non-empty x402 challenge body were found. The docs page returns 404. Request body shape is inferred from context, not documented.
Warnings
- —No OpenAPI or detailed API documentation found (docs page returns 404)
- —x402 challenge body was empty — exact payment parameters (asset address, amount, network) not confirmed from probe
- —Request and response schemas are inferred, not documented
- —Example request body is speculative based on endpoint purpose
Citations
- —The /api/protocol/risk endpoint provides protocol risk via TVL trend analysis and costs $0.50 per callhttps://defi-shield-hazel.vercel.app
- —DeFi Shield offers 69 paid API endpoints selling security intelligence to autonomous AI agents, paid per request with USDC via x402 on Basehttps://defi-shield-hazel.vercel.app
- —Every endpoint supports free GET-based discovery with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Agent discovery card available at /.well-known/agent-card.jsonhttps://defi-shield-hazel.vercel.app
- —The endpoint returned HTTP 402 on POST, confirming it is livehttps://defi-shield-hazel.vercel.app/api/protocol/risk