{"uid":"cap_1QZmEsyPjCIxTkuCo2f4Z","slug":"x402-ottoai-services-b2fc852d","name":"Otto AI Historical Yield Farming Positions","description":"Historical (closed) yield farming positions for a user across all protocols and chains, with realized yield and exit timestamps.","url":"https://x402.ottoai.services/yield-farming-historical","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["userAddress"],"properties":{"userAddress":{"type":"string","description":"EVM wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"status":{"type":"string"},"positions":{"type":"array"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"userAddress":"0x1234567890123456789012345678901234567890"}},"output":{"type":"object"}},"response":{"status":"success","message":"No historical yield positions found","positions":[],"powered_by":"[Powered by $OTTO AI | @useOttoAI]","userAddress":"0x1234567890123456789012345678901234567890"}},"exampleRequest":{"userAddress":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.001","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.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_I8XxxIg_FaBjR0cPdn06h","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":"Retrieves historical (closed) yield farming positions for an EVM wallet address, including realized yield and exit timestamps across all protocols and chains.","exampleAgentPrompt":"Can you pull up the full history of closed yield farming positions for my wallet 0xAbC1234567890defABCDEF1234567890abcdef12, including how much yield I realized and when I exited each position?","exampleUseCases":[{"title":"Audit past DeFi farming performance","prompt":"I need to review all my closed yield farming positions from the last two years to calculate my total realized gains for tax purposes. Can you show me everything I exited across all chains and protocols?"},{"title":"Compare yield earned across protocols","prompt":"Which yield farming protocols did I actually make the most money on? Pull up my historical closed positions so I can see which ones were most profitable and when I exited them."},{"title":"Track exit timing for farming strategy","prompt":"I want to understand when I've historically closed my farming positions and how much yield I captured at those times. Can you show me my full exit history across all my farms?"}],"resultDescription":"An array of historical (closed) yield farming positions for the specified wallet, each including the protocol, chain, realized yield earned, and exit timestamp.","failureModes":["Invalid or malformed EVM wallet address returns an error or empty result","Wallet with no historical yield farming activity returns an empty positions array","Network timeout or upstream data provider unavailability returns a 5xx error","Address with only active (not yet closed) positions returns empty historical data"],"whenToPreferThis":"Use this endpoint when you need a retroactive view of a user's DeFi yield farming activity — specifically positions that have already been closed/exited. Prefer this over live portfolio endpoints when the user wants to audit past performance, calculate realized gains, or review historical DeFi engagement across multiple protocols and chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:16.320Z","isFirstParty":false}