{"uid":"cap_EaJ8_96U0uBQNx-6zHiHv","slug":"yield-xyz-single-yield-metadata-e28f2a96","name":"Yield.xyz Single Yield Metadata","description":"Get full metadata for a single DeFi yield: current APY, TVL, fees, minimum/maximum entry, lock-up/cooldown/warm-up periods, reward mechanics, supported tokens, and whether entry/exit is currently open. Show this before a user commits to a position.","url":"https://mcp.yield.xyz/x402/yields_get?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"yieldId":{"type":"string","description":"Yield ID from yields_get_all, e.g. \"ethereum-eth-lido-staking\""}}},"responseSchema":{"type":"json","example":{"id":"ethereum-eth-lido-staking","network":"ethereum","mechanics":{"type":"staking","cooldownPeriod":{"days":0}},"rewardRate":{"total":0.032},"statistics":{"tvlUsd":"24000000000"}}},"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":{"p10Cents":"0.1000","medianCents":"0.1000","p90Cents":"0.1000","minCents":"0.1000","maxCents":"0.1000","p95Cents":"0.1000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_YxkZ4YlSm-gbNEPuHwx4e","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":"Fetch full metadata for a specific DeFi yield opportunity including current APY, TVL, fees, lock-up periods, reward mechanics, supported tokens, and entry/exit availability.","exampleAgentPrompt":"Before I stake my ETH, pull up the full details for the Lido ETH staking yield on Yield.xyz — I want to see the current APY, TVL, any lock-up or cooldown periods, minimum entry, and whether I can actually enter right now. The yield ID is ethereum-eth-lido-staking.","exampleUseCases":null,"resultDescription":"Returns comprehensive metadata for the requested yield including current APY, total value locked (TVL), fee structure, minimum and maximum entry amounts, lock-up/cooldown/warm-up periods, reward mechanics and distribution details, supported tokens, and whether entry and exit are currently open or gated.","failureModes":["Invalid or unknown yieldId returns an error — must use IDs from yields_get_all","Network/protocol outage may return stale or unavailable data","Payment failure ($0.001 USDC) causes request rejection via x402","Missing yieldId field causes schema validation error"],"whenToPreferThis":"Use this endpoint when you need comprehensive details about a single specific yield before a user commits capital — it provides the full picture including lock-up terms, fees, and live entry/exit status. Prefer over yields_get_all when you already have a yield ID and need deep metadata rather than a broad list.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:39:58.760Z","isFirstParty":false,"canonicalSlug":"yield-xyz-single-yield-metadata-e28f2a96"}