Oracle dependency risk assessment for DeFi protocols, paid per call via x402 on Base.
What it does
The `/api/protocol/oracle-risk` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence for autonomous AI agents. This specific endpoint performs oracle dependency risk assessment for DeFi protocols — evaluating how reliant a protocol is on external price oracles and the associated risks (e.g., oracle manipulation, single points of failure, staleness).
Payment is handled via the x402 protocol using USDC on Base at $0.50 per request. Agents send a POST request with an x402 payment header, the facilitator verifies the USDC payment on-chain, and the endpoint returns a JSON response. Payment settles only on a successful response. The endpoint supports free GET-based discovery that returns metadata and an `llm_usage_prompt` describing expected inputs and outputs.
DeFi Shield is hosted on Vercel and provides additional discovery mechanisms including a health endpoint (`/api/health`) listing all endpoints and pricing, an analytics endpoint (`/api/analytics`), and an A2A agent card at `/.well-known/agent-card.json`. No OpenAPI schema or detailed documentation page was found during crawling, so the exact request/response schema for this endpoint is not confirmed. Based on the pattern of sibling endpoints, the request likely accepts a protocol name or identifier and returns a risk assessment object.
Capabilities
Use cases
- —Assess oracle dependency risk before depositing into a DeFi protocol
- —Evaluate whether a protocol's price feeds are vulnerable to manipulation
- —Compare oracle risk across multiple protocols as part of due diligence
- —Automated agent screening of protocol safety before executing trades
- —Portfolio risk monitoring for oracle-related vulnerabilities
Fit
Best for
- —AI agents performing autonomous DeFi investment decisions
- —Risk analysts evaluating protocol oracle dependencies
- —DeFi portfolio managers monitoring oracle-related exposure
- —Developers building automated protocol safety checks
Not for
- —Real-time oracle price data feeds (this assesses risk, not prices)
- —Non-DeFi oracle use cases (e.g., general data feed monitoring)
- —Users who need free unlimited access without crypto payment
Quick start
# Free discovery (GET returns metadata + llm_usage_prompt)
curl https://defi-shield-hazel.vercel.app/api/protocol/oracle-risk
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/protocol/oracle-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 clear pricing ($0.50) and category context. However, no OpenAPI schema, detailed docs, or example responses were found. The request/response format is inferred from sibling endpoint patterns. The x402 challenge object was empty, so payment details (asset, network, amount) could not be independently verified from the probe.
Warnings
- —No OpenAPI or schema documentation found — request/response format is inferred
- —x402 challenge object was empty; payment parameters (asset, amount, network) not independently verified from probe
- —No /docs page exists (returns 404); endpoint behavior details are based solely on the landing page description
- —Example request JSON is speculative based on sibling endpoint patterns
Citations
- —Oracle dependency risk assessment endpoint priced at $0.50 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
- —Every endpoint supports free GET-based discovery with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Payment settles only on successful responsehttps://defi-shield-hazel.vercel.app
- —Discovery available at /.well-known/agent-card.json and /api/healthhttps://defi-shield-hazel.vercel.app