Governance centralization risk scoring for DeFi protocols via x402-paid API on Base.
What it does
DeFi Shield's `/api/protocol/governance-risk` endpoint provides governance centralization risk scoring for DeFi protocols. 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 charges $0.75 per call, settled in USDC on Base via the x402 payment protocol.
The endpoint sits within the Protocol Intelligence category alongside related endpoints for TVL decomposition, protocol comparison, emission modeling, oracle risk, and bridge risk assessment. Based on the landing page description, it evaluates how centralized a protocol's governance structure is, producing a risk score. However, no detailed request/response schema, parameter documentation, or example payloads were found in the crawled material — the docs page returns 404.
DeFi Shield supports endpoint discovery via GET requests to each endpoint path (returning free metadata including an `llm_usage_prompt`), a health endpoint at `/api/health` listing all endpoints and pricing, and an A2A discovery card at `/.well-known/agent-card.json`. Payment follows the x402 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 successful response.
Capabilities
Use cases
- —Assess governance centralization risk before investing in a DeFi protocol
- —AI agents autonomously evaluating protocol safety as part of portfolio management
- —Comparing governance decentralization across multiple protocols
- —Flagging protocols with high governance centralization for compliance or risk teams
- —Integrating governance risk data into DeFi dashboards or aggregators
Fit
Best for
- —AI agents performing autonomous DeFi due diligence
- —DeFi risk analysts evaluating protocol governance structures
- —Automated portfolio management systems needing governance risk signals
Not for
- —Non-blockchain governance or corporate governance analysis
- —Users who need free or high-volume bulk governance data without per-call payment
Quick start
# Free discovery (returns metadata + llm_usage_prompt)
curl https://defi-shield-hazel.vercel.app/api/protocol/governance-risk
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/protocol/governance-risk \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"protocol": "aave"}'Example
Request
{
"protocol": "aave"
}Endpoint
Quality
The endpoint is live (returns 402 on POST as expected for x402), and the landing page provides pricing and a brief description. However, there is no OpenAPI schema, no docs page (404), no request/response examples, and the x402 challenge body was empty, so exact payment parameters are unknown. The request example is inferred from context.
Warnings
- —No detailed API documentation available — /docs returns 404
- —No OpenAPI or JSON schema found for request/response payloads
- —x402 challenge body was empty — exact payment parameters (asset, amount, payTo) not captured
- —Example request JSON is inferred from naming conventions, not documented
Citations
- —Governance centralization risk scoring endpoint priced at $0.75 per callhttps://defi-shield-hazel.vercel.app
- —69 paid API endpoints selling security intelligence to autonomous AI agents, pay per request with USDC via x402 protocol on Basehttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery via GET requests with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Payment settles only on successful responsehttps://defi-shield-hazel.vercel.app