{"uid":"cap_Nry3eCbNE68pEdl8WGtqQ","slug":"defillama-chain-tvl-history-1ec0bba7","name":"DefiLlama Chain TVL History","description":"Historical DeFi TVL for one chain from DefiLlama — total-value-locked time series for a single chain.","url":"https://defillama.use.x402atlas.com/chain-tvl","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":["chain"],"properties":{"chain":{"type":"string","pattern":"^[^/?#]+$","maxLength":100,"minLength":1,"description":"Chain name (e.g. Ethereum, Arbitrum, Solana); case preserved, no slashes or query characters"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"tvl":{"type":"number","description":"Total value locked in USD on that date"},"date":{"type":"integer","description":"Unix timestamp (seconds) of this data point"}}}},"queried_at":{"type":"string","format":"date-time","description":"When this bridge fetched the upstream data"}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"tvl":123000000000,"date":1700000000}],"queried_at":"2026-07-01T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t8Jiu5Rgum2yF-0qI8uIy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the historical total-value-locked (TVL) time series for a single specified blockchain chain from DefiLlama.","exampleAgentPrompt":"Pull the full historical TVL time series for Arbitrum from DefiLlama so I can see how total value locked has changed over time on that chain.","exampleUseCases":[{"title":"Track DeFi growth on Solana","prompt":"Get me the historical TVL data for Solana so I can see how much value has flowed into DeFi protocols on that chain over time."},{"title":"Analyze Ethereum's peak liquidity","prompt":"Show me the complete TVL time series for Ethereum so I can identify when the most value was locked in DeFi and how it's trended since then."},{"title":"Compare Polygon's DeFi expansion","prompt":"Pull the historical TVL data for Polygon so I can visualize how the chain's DeFi ecosystem has grown and contracted over the past few years."}],"resultDescription":"A time series array of TVL data points for the specified chain, each containing a timestamp and the total USD value locked in DeFi protocols on that chain at that point in time.","failureModes":["Invalid or unrecognized chain name returns an error or empty result","Chain name must match DefiLlama's naming convention (e.g. 'Ethereum' not 'ETH') or lookup fails","Payment failure due to insufficient USDC balance results in 402 response","Network timeout if DefiLlama upstream is slow or unavailable"],"whenToPreferThis":"Use this endpoint when you need the full historical TVL time series for a single specific blockchain chain. Prefer this over the all-chains aggregate endpoint when you want to analyze or visualize one chain's DeFi growth in isolation, or when you need per-chain granularity rather than ecosystem-wide totals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:25.230Z","isFirstParty":false}