{"uid":"cap_RgOqrwa5EWkU_dyjRoTHI","slug":"base-defi-yield-history-risk-score-time-series-8bef9bd5","name":"Base DeFi Yield History & Risk Score Time Series","description":"Daily history of one opportunity's APY, TVL and risk scores. Useful for checking whether a yield is stable or newly inflated, and for trend charts. 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/history/:id?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"},"pathParams":{"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."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"days":{"type":"integer","maximum":730,"minimum":1,"examples":[30],"description":"Look-back in days (default 30)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","model_version","id","points"],"properties":{"id":{"type":"string"},"days":{"type":"integer"},"as_of":{"type":"string","description":"Hour the data describes (ISO 8601, UTC)."},"points":{"type":"array","items":{"type":"object"},"description":"One per UTC day: day, tvl_usd, apy, apy_base, apy_reward."},"scores":{"type":"array","items":{"type":"object"},"description":"Stored scores: ts, total_risk, opportunity_score, sustainability, confidence."},"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_v6CDsCrf0D0HbL8jbjCS0","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 daily APY, TVL, and risk score history for a specific Base DeFi yield opportunity over a configurable look-back window.","exampleAgentPrompt":"Pull the last 90 days of APY, TVL, and risk score history for Base DeFi opportunity e0672197-9f3e-4414-bca5-e6b4c90aa469 so I can see whether that yield has been stable or if it just spiked recently.","exampleUseCases":[{"title":"Detect freshly inflated yield spike","prompt":"That Aerodrome pool on Base is showing 85% APY right now — can you pull 60 days of APY history for opportunity e0672197-9f3e-4414-bca5-e6b4c90aa469 so I can tell if this is a real sustained yield or a brand-new spike?"},{"title":"Risk score trend before entering position","prompt":"Before I deposit into this Base vault, can you show me the last 30 days of risk scores and TVL history for opportunity id abc123-defi-base so I can see if the risk profile has been worsening?"},{"title":"Build historical APY chart for research report","prompt":"I need 365 days of daily APY and TVL data for Base DeFi opportunity xyz789:pool#main to build a trend chart showing how this yield has evolved over the past year."}],"resultDescription":"A JSON object containing: an array of daily data points (each with date, TVL in USD, total APY, base APY, and reward APY), an array of risk score snapshots (timestamp, total risk, opportunity score, sustainability, confidence), model version, data freshness in minutes, and a disclaimer. Covers up to the requested look-back window (default 30 days, max 730 days).","failureModes":["404 returned for unknown or unrecognized opportunity ids — agent must first fetch a valid id from the free /api/v1/opportunities endpoint","400 returned for malformed path parameters or invalid query arguments (e.g. days outside 1-730 range)","503 returned while underlying data is refreshing — agent should retry after a short delay","Payment not charged on non-200 responses, so 404/400/503 are safe to retry without financial risk","Data age (data_age_min) may be high during periods of upstream data lag"],"whenToPreferThis":"Use this endpoint when you need time-series historical data for a single Base DeFi opportunity — APY trend, TVL growth/decline, or risk score evolution over days or months. Prefer this over the snapshot/scoring endpoints when the user wants to assess stability, spot yield inflation, build charts, or compare current values to historical averages. Not suitable for discovering opportunities (use /api/v1/opportunities first to get valid ids) or for cross-protocol comparisons in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:30:32.530Z","isFirstParty":false,"canonicalSlug":"base-defi-yield-history-risk-score-time-series-8bef9bd5"}