{"uid":"cap_fus0xQI8NrsIbYcWRfE0J","slug":"mcp-yield-xyz-yield-tvl-history-4e81c3e3","name":"mcp.yield.xyz – Yield TVL History","description":"Historical total-value-locked (TVL) for a yield over time — track inflows/outflows and protocol growth across 1d/7d/30d/90d/1y windows.","url":"https://mcp.yield.xyz/x402/yields_get_tvl_history","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"limit":{"type":"integer","maximum":365,"minimum":1},"offset":{"type":"integer","minimum":0},"period":{"enum":["1d","7d","30d","90d","1y","all"],"type":"string"},"yieldId":{"type":"string","description":"Yield ID from yields_get_all"},"interval":{"enum":["day","week","month"],"type":"string"}}},"responseSchema":{"type":"json","example":{"items":[{"tvl":"124500000.12","tvlRaw":"124500000120000","timestamp":"2026-06-01T00:00:00.000Z"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_ea4jRxWiwqONZd7Ny5AFm","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 time-series data of historical total-value-locked (TVL) for a specific DeFi yield, enabling analysis of inflows, outflows, and protocol growth over configurable time windows.","exampleAgentPrompt":"Show me the monthly TVL history for yield ID 'eth-lido-steth' over the last 90 days so I can see whether the protocol has been growing or shrinking.","exampleUseCases":null,"resultDescription":"A time-series array of TVL data points for the requested yield, each containing a timestamp and the total value locked at that point. Data is scoped to the requested period (e.g. 90d), aggregated at the chosen interval (day/week/month), and optionally bounded by from/to date filters.","failureModes":["Invalid or unknown yieldId returns an error or empty result set","Period/interval combination with no data returns empty array","from/to date range outside available history returns partial or empty data","limit/offset misconfiguration returns unexpected pagination behavior","Malformed date strings in from/to fields cause validation errors"],"whenToPreferThis":"Use this endpoint when you need historical TVL trends for a specific yield — for example to chart protocol growth, identify capital flight, compare TVL across time windows, or compute average locked value. Prefer this over the single-yield metadata endpoint when you need time-series data rather than current TVL snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:38:46.997Z","isFirstParty":false}