{"uid":"cap_EhbYBCtpXUWKKwzTWHzGF","slug":"realized-apy-base-yields-quoted-vs-realized-308daacd","name":"Realized APY: Base Yields, Quoted vs Realized","description":"Realized APY for Base vaults and lending markets: the APY depositors actually earned over 7 and 30 days, read from on-chain share prices, next to the quoted APY, with a verdict (matches, overstated, understated) and a risk score. Useful for finding the best yields on Base and spotting advertised yields that are not being paid. Ids work with every other route. 404 for unknown paths and 400 for invalid arguments, before any payment; 503 while data refreshes; charged only for a 200.","url":"https://intel.fintechhodl.com/api/v1/yields?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","properties":{"sort":{"enum":["risk_adjusted","realized_apy","quoted_apy","sustainable_apy","tvl"],"type":"string","description":"Order: risk_adjusted (default) ranks by opportunity score; realized_apy by the 30-day realized APY; sustainable_apy by the APY expected once incentives fade."},"type":{"enum":["lending","vault","staking","fixed_yield","lp","stable_lp","concentrated","rwa"],"type":"string","description":"Opportunity type."},"asset":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,20}$","examples":["USDC"],"description":"Token symbol, e.g. USDC or WETH."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"How many items (default 20)."},"min_apy":{"type":"number","maximum":100000,"minimum":0,"description":"Minimum quoted APY, percent."},"risk_max":{"type":"number","maximum":100,"minimum":0,"description":"Maximum risk score (0-100, lower is lower modelled risk)."},"stable_only":{"type":"boolean","description":"Only stablecoin principal."},"realized_only":{"type":"boolean","description":"Only opportunities with a realized on-chain APY."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","model_version","coverage","items"],"properties":{"as_of":{"type":"string","description":"Hour the data describes (ISO 8601, UTC)."},"count":{"type":"integer","description":"Matches before the limit."},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opportunity id, usable with every other route."},"apy":{"type":"number","description":"Quoted APY, percent."},"type":{"type":"string"},"asset":{"type":["string","null"]},"market":{"type":"string"},"tvl_usd":{"type":"number"},"apy_base":{"type":["number","null"],"description":"Quoted APY without token rewards."},"protocol":{"type":"string"},"apy_gap_pp":{"type":["number","null"],"description":"Quoted minus realized, percentage points."},"apy_reward":{"type":["number","null"],"description":"Part of the quoted APY paid in token incentives."},"risk_score":{"type":"number"},"realized_days":{"type":"integer"},"accrual_source":{"type":["object","null"],"description":"Contract and kind of the on-chain number, to verify it."},"realized_as_of":{"type":["string","null"],"description":"UTC day of the newest on-chain reading."},"realized_apy_7d":{"type":["number","null"],"description":"APY earned over the last 7 days, from on-chain share prices, compounded."},"sustainable_apy":{"type":"number"},"realized_apy_30d":{"type":["number","null"],"description":"APY earned over the last 30 days."},"opportunity_score":{"type":"number"},"realized_vs_quoted":{"enum":["matches","overstated","understated","unknown"],"type":"string"},"quoted_apy_compared":{"enum":["base","total"],"type":"string","description":"Which quote the realized figure is compared with."}}}},"coverage":{"type":"object","description":"tracked: opportunities considered; with_realized: those with an on-chain realized APY."},"disclaimer":{"type":"string"},"data_age_min":{"type":"number","description":"Minutes since the newest pool data."},"model_version":{"type":"string","description":"Scoring model version."}}}}}}},"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_XX6LVir9tSf_1nCADpXZP","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 realized vs quoted APY for Base DeFi vaults and lending markets, with a verdict (matches/overstated/understated) and risk score, so depositors can verify what they actually earned.","exampleAgentPrompt":"Show me the top 10 stablecoin yield opportunities on Base sorted by risk-adjusted score, and flag any where the quoted APY is higher than what depositors actually earned over the last 30 days.","exampleUseCases":[{"title":"Spotting overstated yields on Base","prompt":"Which Base lending markets or vaults are advertising APYs higher than what depositors actually earned over the past month? Show me up to 20 results and flag the ones where the quoted APY is overstated."},{"title":"Best verified USDC yield on Base","prompt":"Find the top 5 USDC lending or vault opportunities on Base that have a realized 30-day APY to back up their advertised rate, with a risk score below 50."},{"title":"Risk-adjusted yield screening for stablecoins","prompt":"Give me the best risk-adjusted stablecoin-only yield opportunities on Base right now, sorted by opportunity score, and tell me which ones have realized APYs that match their quoted rates."}],"resultDescription":"A ranked list of Base DeFi yield opportunities, each with the quoted APY, realized 7-day and 30-day APY, a verdict on whether the quoted APY matches, overstates, or understates reality, a risk score (0-100), TVL, opportunity type, and a unique ID compatible with other routes on this API. Also includes an as_of timestamp and total match count.","failureModes":["404 returned for unknown or malformed paths before any payment","400 returned for invalid query parameters (e.g. out-of-range values, bad asset symbols) before any payment","503 returned while the underlying on-chain data is refreshing; retry after a short delay","No results returned if filters are too restrictive (e.g. very low risk_max combined with high min_apy)"],"whenToPreferThis":"Choose this endpoint when you need to verify whether a Base DeFi yield opportunity is actually paying its advertised rate, or when ranking opportunities by realized (on-chain) rather than quoted APY. It is uniquely suited for detecting overstated yields and for risk-adjusted yield discovery on Base. Prefer it over generic DeFi aggregators when you need the quoted-vs-realized verdict and risk scoring specific to Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:45.202Z","isFirstParty":false,"canonicalSlug":"realized-apy-base-yields-quoted-vs-realized-308daacd"}