{"uid":"cap_iP6v4TLWyYX9Y0AsSNJ8Y","slug":"defillama-tvl-yields-gateway-01de09d5","name":"DefiLlama TVL/Yields Gateway","description":"Call DefiLlama TVL/yields through our metered gateway: our rate-limit budget and a 300s cache absorb your polling, so your loop never sees a 429. Inputs: path (upstream path, e.g. /ping) and q (raw query string). Returns the upstream JSON under 'data'.","url":"https://x402.shizu.me/gw/defillama","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["method"],"properties":{"method":{"const":"GET"},"queryParams":{"type":"object","required":["path","q"],"properties":{"q":{"type":"string"},"path":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{},"path":"/ping","upstream":"defillama"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c0TzP9kwly7Ckiv8dHzou","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Proxies DefiLlama TVL and yield data through a metered gateway with rate-limit pooling and 300-second caching to prevent upstream 429 errors","exampleAgentPrompt":"Pull the current TVL for Uniswap from DefiLlama — use the path /protocol/uniswap — without worrying about rate limits.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a 'data' field containing the upstream DefiLlama API response (TVL figures, yield pool data, protocol stats, etc.) as-is, served from a 300-second cache when available.","failureModes":["Upstream DefiLlama path not found — returns upstream 404 wrapped in error","Invalid path format causes routing failure","DefiLlama upstream outage propagates after cache expires","Stale cache data up to 300 seconds old returned instead of live data","Payment failure if USDC balance insufficient for $0.002 per call"],"whenToPreferThis":"Use this endpoint when your agent loop needs to poll DefiLlama TVL or yield data repeatedly and risks hitting upstream rate limits (429s). The 300-second cache and shared rate-limit budget make it ideal for high-frequency DeFi monitoring workflows where freshness within 5 minutes is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:48.944Z","isFirstParty":false}