DeFi protocol TVL ranking with risk assessment, paid per call via x402 on Base.
What it does
The yield-report endpoint from the Intel API (intel.hugen.tokyo) returns a DeFi protocol TVL (Total Value Locked) ranking with AI-generated risk assessments for a specified blockchain. It is part of a broader suite of AI-synthesized crypto due-diligence endpoints that aggregate multiple data sources into a single call with risk scoring and actionable verdicts.
The endpoint accepts two optional query parameters: `chain` (defaults to "base") and `limit` (defaults to 20, controlling how many protocols are returned). The response includes a ranked list of DeFi protocols with their TVL in USD, a risk tier rating (e.g., A, B), category (e.g., Lending, DEX), an overall ecosystem verdict, and actionable recommendations. The sample response in the 402 challenge shows protocols like Aave V3 ($1.5B TVL, risk tier A) and Aerodrome ($800M TVL, risk tier B) on Base.
Payment is $0.50 USDC per call on Base via the x402 protocol. Alternative access methods include an MCP gateway at mcp.hugen.tokyo, a free API key with $0.05 credit (no wallet needed), or the `x402-pay` Python SDK for one-line access. The API is versioned at 0.1.0 and serves an OpenAPI 3.1 spec. Response schemas are not formally defined in the OpenAPI spec, so the exact structure must be inferred from the sample data in the 402 challenge.
Capabilities
Use cases
- —Ranking DeFi protocols by TVL on a given chain before allocating capital
- —Automated risk screening of DeFi protocols for portfolio management agents
- —Comparing protocol safety tiers across chains for treasury diversification
- —Building dashboards that surface top DeFi opportunities with risk context
Fit
Best for
- —AI agents performing DeFi due diligence autonomously
- —Developers building crypto analytics dashboards
- —Portfolio managers screening DeFi protocols by risk tier
Not for
- —Real-time trading signals or sub-second price feeds
- —Non-crypto or traditional finance yield analysis
- —Users who need free unlimited access (each call costs $0.50)
Quick start
# Using the x402-pay Python SDK
pip install x402-pay
import x402_pay
r = x402_pay.get('https://intel.hugen.tokyo/intel/yield-report?chain=base&limit=10')
print(r.json())Example
Response
{
"chain": "Base",
"verdict": "Base DeFi ecosystem has $3.2B TVL across 45 protocols. Top protocols are audited with stable TVL trends.",
"top_protocols": [
{
"name": "Aave V3",
"tvl_usd": 1500000000,
"category": "Lending",
"risk_tier": "A"
},
{
"name": "Aerodrome",
"tvl_usd": 800000000,
"category": "DEX",
"risk_tier": "B"
}
],
"recommendations": [
"Aave V3 offers lowest risk with highest TVL",
"Verify audit status before depositing"
]
}Endpoint
Quality
The endpoint is live (402 challenge captured) with a clear OpenAPI spec and sample response data. However, the response schema is not formally defined in the OpenAPI spec, documentation is minimal (no dedicated docs pages beyond the auto-generated Swagger), and the sample response comes from the 402 challenge rather than actual endpoint output. The API is at version 0.1.0, suggesting early maturity.
Warnings
- —Response schema is not formally defined in the OpenAPI spec; structure inferred from 402 challenge sample data only
- —API version 0.1.0 — early stage, interface may change
- —No dedicated documentation beyond auto-generated OpenAPI docs page
- —Sample response in 402 challenge may not reflect full production output
Citations
- —The yield-report endpoint is described as 'DeFi protocol TVL ranking with risk assessment'https://intel.hugen.tokyo/openapi.json
- —The API is titled 'Intel API — AI Due Diligence for Crypto' at version 0.1.0https://intel.hugen.tokyo/docs
- —Payment is $0.50 USDC on Base per callhttps://intel.hugen.tokyo/intel/yield-report
- —Alternative access via MCP gateway, API key, or x402-pay SDKhttps://intel.hugen.tokyo/intel/yield-report
- —Query parameters are chain (default 'base') and limit (default 20)https://intel.hugen.tokyo/openapi.json