{"uid":"cap_kVG_Ws_UAg2QDqYuoCn7E","slug":"defi-tvl-momentum-a85d8005","name":"DeFi TVL Momentum","description":"Returns the total value locked of a protocol, its distribution across chains, and the change over one day, seven days and thirty days, together with its share of the category. The distinction that justifies the service is between flow and valuation: TVL is denominated in dollars, so when the price of the deposited token falls the TVL falls with it although not one user withdrew anything, and a thirty percent TVL drop in a week when the token lost thirty percent is not an outflow.","url":"https://finanz.halowerk.com/v1/defi-tvl-momentum","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","maxLength":40,"description":"Restrict the overview to one chain."},"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"protocol":{"type":"string","maxLength":80,"description":"Protocol slug, e.g. aave, uniswap. Without it the largest protocols are returned."}}},"responseSchema":null,"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_57vxpUMNOozjQ9fi0TS9M","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 total value locked for a DeFi protocol with chain-level breakdown, 1/7/30-day changes, and category share — distinguishing price-driven TVL changes from actual user flows","exampleAgentPrompt":"What's the current TVL for Lido, broken down by chain, and how has it changed over the past week and month — and can you tell me whether any drop is from actual withdrawals or just the token losing value?","exampleUseCases":[{"title":"Detect real capital flight in DeFi","prompt":"TVL on MakerDAO dropped 25% this month — can you tell me if that's real users pulling out money or just DAI/ETH price movements, and show me the chain-by-chain breakdown?"},{"title":"Monitor DeFi protocol momentum for portfolio review","prompt":"Give me TVL momentum for Aave over the last 30 days, including its share of the lending category and how much of any change is price-driven versus actual user flows."},{"title":"Compare protocol dominance within a DeFi category","prompt":"What's Curve Finance's current TVL and what share of the DEX category does it hold — and has it been gaining or losing ground over the past week?"}],"resultDescription":"A JSON object containing the protocol's total TVL in USD, its breakdown by chain (chain name and USD value), percentage changes over 1, 7, and 30 days, its share of its DeFi category, and contextual signals distinguishing price-driven TVL movements from actual user deposit/withdrawal flows.","failureModes":["Unknown or misspelled protocol identifier returns an error or empty result","Protocol not indexed by the underlying data source returns null TVL","Stale data if the underlying DeFi data feed has a lag, especially for newer or smaller protocols","Price feed unavailability may cause inaccurate flow-vs-valuation decomposition","Rate limit or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Prefer this endpoint when you need to distinguish whether a TVL change in a DeFi protocol reflects real capital movement versus token price fluctuation — a nuance most raw TVL APIs ignore. It is also the right choice when you need chain-level TVL distribution and category-relative share in a single call, without stitching together multiple data sources. Choose it over generic DeFi data aggregators when the flow-vs-valuation context is analytically important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:31:34.437Z","isFirstParty":false}