{"uid":"cap_wz9zuFaqnNOSrXXwyfapB","slug":"daily-tvl-history-for-one-chain-up-to-2-years-e6dc1e81","name":"Daily TVL History for One Chain (Up to 2 Years)","description":"Daily TVL history for one chain (up to 2 years) — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/defi/chain-tvl-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"days":{"type":"integer","maximum":730,"minimum":2,"description":"optional 2-730, default 90"},"chain":{"type":"string","description":"required: chain name, e.g. Ethereum"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"defi-chain-tvl-history","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aHMITshMU8Uy8k6TZbO_l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily Total Value Locked (TVL) history for a specified blockchain, covering up to 730 days of data.","exampleAgentPrompt":"Can you pull the daily TVL history for Ethereum over the last 365 days so I can see how DeFi activity has trended on that chain?","exampleUseCases":[{"title":"DeFi growth research on Arbitrum","prompt":"Show me the daily TVL history for Arbitrum over the past 180 days — I want to understand how DeFi activity has grown on that chain."},{"title":"Year-over-year TVL comparison on Solana","prompt":"Fetch the full 2 years of daily TVL data for Solana so I can compare year-over-year DeFi growth."},{"title":"Recent TVL trend monitoring for Polygon","prompt":"What does the TVL trend look like for Polygon over the last 30 days? Give me the daily breakdown."}],"resultDescription":"A time series of daily TVL values for the requested blockchain, covering up to 730 days. Each data point includes a date and the corresponding total value locked in USD for that chain, enabling trend analysis and historical comparison.","failureModes":["Missing or unrecognized chain name returns an error or empty result","Days parameter outside 2–730 range is rejected with a validation error","Chain with no DeFi data tracked may return an empty or sparse series","Payment failure via x402 protocol prevents access to data","Upstream DeFi data provider outage may cause stale or unavailable data"],"whenToPreferThis":"Use this endpoint when you need per-day TVL granularity for a single blockchain over a medium-to-long historical window (up to 2 years). It is ideal for trend analysis, charting DeFi growth, or generating time-series reports for a specific chain. If you need cross-chain TVL comparison, multi-protocol breakdowns, or real-time snapshots, consider other endpoints in the same network.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:42:30.434Z","isFirstParty":false,"canonicalSlug":"daily-tvl-history-for-one-chain-up-to-2-years-e6dc1e81"}