{"uid":"cap_XSKrVj_Aq_TNr0X8XxVEz","slug":"api-web3identity-com-bed94a64","name":"DefiLlama TVL Lookup for Yearn Finance","description":"Get Total Value Locked for a DeFi protocol from DefiLlama","url":"https://api.web3identity.com/api/defi/tvl/yearn","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"tvl":{"type":"number"},"chains":{"type":"array"},"protocol":{"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"tvl":217204800.99265176,"cached":false,"source":"defillama","protocol":"yearn","latencyMs":554,"timestamp":"2026-06-16T01:14:39.396Z"}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010000","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.010000/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_YgHbLN-W7UhMQ9KkhS8_4","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 the Total Value Locked (TVL) for the Yearn Finance DeFi protocol, sourced from DefiLlama","exampleAgentPrompt":"What's the current total value locked for Yearn Finance across all chains, according to DefiLlama?","exampleUseCases":[{"title":"Monitor Yearn Finance protocol health","prompt":"Can you check how much value is currently locked in Yearn Finance and let me know if it's above $500 million? I want to use this as a health signal before making a yield farming decision."},{"title":"Compare DeFi protocol TVL sizes","prompt":"I'm putting together a comparison of major DeFi yield protocols. Pull the current TVL for Yearn Finance from DefiLlama so I can benchmark it against the others on my list."},{"title":"Track Yearn TVL chain breakdown","prompt":"Which chains does Yearn Finance have locked value on right now, and what's the total TVL across all of them? I'm trying to understand where their liquidity is concentrated."}],"resultDescription":"Returns a JSON object containing the current TVL as a number, the protocol name (yearn), and an array of chains where Yearn Finance has locked value, sourced from DefiLlama aggregated data.","failureModes":["DefiLlama upstream unavailable — returns error or stale data","Protocol not found or renamed in DefiLlama index","Payment failure (402) if x402 payment header is missing or insufficient","Rate limiting if too many requests in short succession"],"whenToPreferThis":"Use this endpoint when you specifically need Yearn Finance TVL data from DefiLlama and want a simple, pre-routed GET request without needing to construct a DefiLlama API path yourself. Ideal for agents that need DeFi protocol health signals as part of a broader workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:07:17.221Z","isFirstParty":false}