{"uid":"cap_Omf3jSOsymofNFBR3gjDR","slug":"base-defi-yield-premium-risk-intelligence-1d022ebc","name":"Base DeFi Yield Premium & Risk Intelligence","description":"Why one opportunity pays more than a reference: the APY gap in percentage points, explained by risk dimensions, incentives and extra dependencies. Useful for judging whether a higher yield is worth its extra risk. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200.","url":"https://intel.fintechhodl.com/api/v1/yield-premium?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9:._#+-]{1,120}$","examples":["e0672197-9f3e-4414-bca5-e6b4c90aa469"],"description":"Opportunity id, as returned by the free /api/v1/opportunities route."},"benchmark":{"type":"string","pattern":"^[A-Za-z0-9:._#+-]{1,120}$","examples":["e0672197-9f3e-4414-bca5-e6b4c90aa469"],"description":"Reference opportunity id (optional); by default a low-risk lending market on the same asset."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","model_version","id","benchmark_id","premium_pp"],"properties":{"id":{"type":"string"},"apy":{"type":"number"},"as_of":{"type":"string","description":"Hour the data describes (ISO 8601, UTC)."},"drivers":{"type":"array","items":{"type":"object"},"description":"Risk dimensions behind the gap."},"disclaimer":{"type":"string"},"premium_pp":{"type":"number","description":"APY gap, percentage points."},"explanation":{"type":"string"},"benchmark_id":{"type":"string"},"data_age_min":{"type":"number","description":"Minutes since the newest pool data."},"incentive_pp":{"type":"number","description":"Part of the gap from token incentives."},"benchmark_apy":{"type":"number"},"model_version":{"type":"string","description":"Scoring model version."},"extra_dependencies":{"type":"array","items":{"type":"object"},"description":"Dependencies the reference does not have."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ArpeF_cIDBdGBVul450xW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the APY gap (in percentage points) between a DeFi opportunity and a benchmark, with risk dimension drivers, incentive breakdown, and extra dependencies explaining why the premium exists.","exampleAgentPrompt":"Can you pull up the yield premium analysis for Base DeFi opportunity e0672197-9f3e-4414-bca5-e6b4c90aa469 and tell me why it pays more than the default low-risk benchmark — specifically how much of the gap comes from incentives vs real risk?","exampleUseCases":[{"title":"Evaluating a high-yield LP before depositing","prompt":"I'm looking at a Base liquidity pool with id e0672197-9f3e-4414-bca5-e6b4c90aa469 that's paying 18% APY — can you explain why it pays so much more than a basic Aave lending position, and break down how much of that premium is token incentives versus actual risk?"},{"title":"Comparing two Morpho vaults for risk-adjusted return","prompt":"I want to compare two Morpho vault opportunities on Base — id abc123-vault is yielding 12% and I'm using def456-vault as my benchmark at 6%. Can you show me the yield premium breakdown and what extra dependencies or risk dimensions are driving that 6 percentage point gap?"},{"title":"Screening DeFi yields for a risk-aware portfolio","prompt":"Before I allocate capital to Base opportunity id zyx987-pool, can you give me the risk-adjusted yield premium analysis versus the default benchmark so I can decide if the extra return is worth the additional protocol and oracle dependencies?"}],"resultDescription":"A JSON object containing: the APY gap in percentage points (premium_pp), the portion attributable to token incentives (incentive_pp), the benchmark APY and opportunity APY, an array of risk dimension drivers explaining the gap, extra protocol/oracle/stablecoin dependencies the opportunity has beyond the benchmark, a human-readable explanation, the data timestamp (as_of), data freshness in minutes, and the scoring model version used.","failureModes":["404 if the opportunity id is unknown or not tracked","400 if the id or benchmark parameter fails pattern validation (before any charge)","503 while underlying pool data is refreshing (no charge)","Benchmark id 404 if the provided reference opportunity is unknown","Stale data indicated by elevated data_age_min when upstream sources are slow"],"whenToPreferThis":"Use this endpoint when you need to understand WHY a specific Base DeFi yield is higher than a reference rate — not just that it is higher. It is the right choice when you want a structured risk decomposition (incentives vs structural risk vs dependencies) for a single opportunity pair rather than a ranked list or historical trend. Prefer it over the risk score endpoint when you need the yield spread itself quantified, and over the history endpoint when you want a point-in-time explanation rather than a time series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:30:35.765Z","isFirstParty":false,"canonicalSlug":"base-defi-yield-premium-risk-intelligence-1d022ebc"}