{"uid":"cap_oLZVzqxMLcJzt2ZCEX83q","slug":"defi-protocol-tvl-metrics-lookup-defillama-6176cf59","name":"DeFi Protocol TVL & Metrics Lookup (DefiLlama)","description":"Deep dive on any DeFi protocol by its DefiLlama slug (aave-v3, lido, uniswap…): current Total Value Locked, market cap, category, the chains it spans, a per-chain TVL breakdown, and a 30-day TVL history. Everything you need to size up a protocol in one call. Sourced from DefiLlama.","url":"https://crypto.apitoll.cloud/v1/crypto/protocol","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":{"protocol":{"type":"string","description":"DefiLlama protocol slug (aave-v3, lido, uniswap, …). Defaults to aave-v3."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"object","properties":{"name":{"type":"string"}}},"symbol":{"type":"string"},"mcapUsd":{"type":"number"},"category":{"type":"string"},"chainTvls":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string"},"tvlUsd":{"type":"number"}}}},"tvlHistory":{"type":"array","items":{"type":"object","properties":{"date":{"type":"number"},"tvlUsd":{"type":"number"}}}},"currentTvlUsd":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"name":"Lido","slug":"lido","chains":["Ethereum"],"source":{"name":"DefiLlama"},"symbol":"LDO","mcapUsd":230000000,"category":"Liquid Staking","chainTvls":[{"chain":"Ethereum","tvlUsd":25000000000}],"tvlHistory":[{"date":1781000000,"tvlUsd":24800000000}],"currentTvlUsd":25000000000}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"protocol":"aave-v3"}}},"response":{"name":"Aave V3","slug":"aave-v3","chains":["Base","Sonic","Binance","Avalanche","Fantom","Optimism","Soneium","Linea","xDai","zkSync Era","Celo","Polygon","Ethereum","Scroll","X Layer","Harmony","MegaETH","Mantle","Arbitrum","Metis","Plasma"],"source":{"url":"https://defillama.com/protocol/aave-v3","name":"DefiLlama"},"symbol":"AAVE","mcapUsd":null,"category":"Lending","chainTvls":[{"chain":"Ethereum","tvlUsd":10330480979},{"chain":"Plasma","tvlUsd":578367552},{"chain":"Arbitrum","tvlUsd":424203708},{"chain":"Base","tvlUsd":388782599},{"chain":"Avalanche","tvlUsd":254823498},{"chain":"Binance","tvlUsd":154287118},{"chain":"Polygon","tvlUsd":113734733},{"chain":"Mantle","tvlUsd":93496339},{"chain":"MegaETH","tvlUsd":87474944},{"chain":"X Layer","tvlUsd":68187057},{"chain":"xDai","tvlUsd":52791275},{"chain":"Optimism","tvlUsd":42926863},{"chain":"Linea","tvlUsd":11677971},{"chain":"Sonic","tvlUsd":8686737},{"chain":"Celo","tvlUsd":4674565},{"chain":"Scroll","tvlUsd":1793681},{"chain":"zkSync Era","tvlUsd":824237},{"chain":"Metis","tvlUsd":303569},{"chain":"Soneium","tvlUsd":162389},{"chain":"Fantom","tvlUsd":3371},{"chain":"Harmony","tvlUsd":0}],"tvlHistory":[{"date":1779148800,"tvlUsd":13396778824},{"date":1779235200,"tvlUsd":13356889880},{"date":1779321600,"tvlUsd":13430516663},{"date":1779408000,"tvlUsd":13641921381},{"date":1779494400,"tvlUsd":13421830678},{"date":1779580800,"tvlUsd":13774089048},{"date":1779667200,"tvlUsd":13750611881},{"date":1779753600,"tvlUsd":13767329264},{"date":1779840000,"tvlUsd":13471490728},{"date":1779926400,"tvlUsd":13381381169},{"date":1780012800,"tvlUsd":13210325630},{"date":1780099200,"tvlUsd":13129204752},{"date":1780185600,"tvlUsd":13326197278},{"date":1780272000,"tvlUsd":13321699811},{"date":1780358400,"tvlUsd":13177806662},{"date":1780444800,"tvlUsd":12344846361},{"date":1780531200,"tvlUsd":12038657448},{"date":1780617600,"tvlUsd":12077282404},{"date":1780704000,"tvlUsd":11472366264},{"date":1780790400,"tvlUsd":11345083647},{"date":1780876800,"tvlUsd":11939503887},{"date":1780963200,"tvlUsd":11896541183},{"date":1781049600,"tvlUsd":11557464731},{"date":1781136000,"tvlUsd":11418337368},{"date":1781222400,"tvlUsd":11621020940},{"date":1781308800,"tvlUsd":11766097241},{"date":1781395200,"tvlUsd":11883145443},{"date":1781481600,"tvlUsd":12159586869},{"date":1781568000,"tvlUsd":12422853077},{"date":1781627867,"tvlUsd":12617683186}],"currentTvlUsd":12617683185}},"exampleRequest":{"protocol":"aave-v3"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VIpeVN6U-yCFvZQR7lElT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current TVL, market cap, category, supported chains, per-chain TVL breakdown, and 30-day TVL history for any DeFi protocol by its DefiLlama slug.","exampleAgentPrompt":"Can you pull up Lido's current TVL, market cap, which chains it runs on, the per-chain TVL breakdown, and its 30-day TVL history from DefiLlama?","exampleUseCases":null,"resultDescription":"A JSON object containing the protocol's name, symbol, category, current total TVL in USD, market cap in USD, an array of supported chain names, a per-chain TVL breakdown (array of {chain, tvlUsd} objects), and a 30-day TVL history (array of {date, tvlUsd} timestamped data points). Data is sourced from DefiLlama.","failureModes":["Invalid or unknown protocol slug returns an error or empty result — verify the exact DefiLlama slug (e.g. 'aave-v3' not 'aave')","Protocol may have been delisted or renamed on DefiLlama, causing a 404 or empty response","Missing 'protocol' query param defaults to aave-v3, which may not be the intended protocol","TVL data may lag by minutes if DefiLlama's upstream indexers are delayed","Network or payment authorization failure (x402) may prevent the call from completing"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, single-call snapshot of a specific DeFi protocol including TVL, market cap, multi-chain presence, and historical TVL trend. Prefer this over generic crypto price endpoints when the user wants DeFi-specific metrics like TVL or chain distribution. Ideal for protocol due diligence, DeFi research, or building dashboards that track on-chain liquidity depth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:22.810Z","isFirstParty":false}