APY decomposition, sustainability scoring, and wash trading detection for DeFi yield opportunities.
What it does
The yield-analysis endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence to autonomous AI agents. This specific endpoint performs APY decomposition, sustainability scoring, and wash trading detection on DeFi yield opportunities. It is accessed via POST at `/api/defi/yield-analysis` and costs $0.75 per call, paid in USDC on Base via the x402 protocol.
DeFi Shield is designed for agent-to-agent commerce: an AI agent sends a POST request with an x402 payment header containing a USDC payment token, the x402 facilitator verifies the payment on Base, the endpoint processes the request and returns JSON, and payment settles only on a successful response. Every endpoint also supports a free GET request for discovery purposes, returning metadata and an `llm_usage_prompt` to help agents understand how to call it.
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. Pricing ranges from $0.01 to $2.50 per call across the 69 endpoints. Discovery is available via `/.well-known/agent-card.json` and `/api/health` for full endpoint listing and pricing.
Capabilities
Use cases
- —AI agents evaluating yield farming opportunities before committing funds
- —Automated portfolio managers assessing sustainability of advertised APYs
- —Risk scoring pipelines flagging yield sources with wash trading indicators
- —DeFi aggregators comparing yield quality across protocols
- —Agent-based due diligence on new liquidity mining programs
Fit
Best for
- —Autonomous AI agents needing programmatic yield risk assessment
- —DeFi portfolio automation requiring APY sustainability checks
- —Security-focused workflows screening yield opportunities for wash trading
Not for
- —Manual human-driven yield farming research (no UI provided)
- —Real-time trading execution or order placement
- —Non-DeFi yield analysis (e.g., traditional finance fixed income)
Quick start
# Free discovery (GET)
curl https://defi-shield-hazel.vercel.app/api/defi/yield-analysis
# Paid request (POST, requires x402 payment)
curl -X POST https://defi-shield-hazel.vercel.app/api/defi/yield-analysis \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x..."}'Example
Request
{
"address": "0x1234567890abcdef1234567890abcdef12345678"
}Endpoint
Quality
The endpoint is live (402 challenge confirmed) and the landing page provides clear pricing and a general description of capabilities, but there is no OpenAPI schema, no detailed request/response documentation, and no example responses. The request body schema and response format are inferred from the landing page quick-start example.
Warnings
- —No OpenAPI or JSON schema available for request or response bodies
- —No dedicated docs page found (returns 404)
- —Example request and response fields are inferred from the landing page quick-start; actual parameters may differ
- —x402 challenge object was empty — no payment details (amount, token, network) were captured in the probe
Citations
- —Yield-analysis endpoint costs $0.75 per call and performs APY decomposition, sustainability scoring, wash trading detectionhttps://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints across 11 categories, priced $0.01–$2.50, paid in USDC on Base via x402https://defi-shield-hazel.vercel.app
- —Every endpoint supports free GET for discovery with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Discovery available at /.well-known/agent-card.json and /api/healthhttps://defi-shield-hazel.vercel.app