{"uid":"cap_HA00DGXdjGXEPv7sFSStD","slug":"acepilot-position-yield-aerodrome-pool-historical-yield-evidence-e79e9d54","name":"AcePilot Position Yield — Aerodrome Pool Historical Yield Evidence","description":"Historical on-chain evidence for Aero pools on Base. Compare query purposes, prices and availability before paying with x402 USDC.","url":"https://aeroacepilot.xyz/v1/position-yield?utm_source=zero.xyz","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":["pool","window_h","target"],"properties":{"pool":{"enum":["0x422df9aa896e883c9cdcbad309c0785b7364a1cf","0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2","0x42609aa1e58c5dd7e5a012dc74118fff975f0eac","0x2836e062a3fe75943a7f4a552e2365b98e414e75","0x41e21950362b1014bc629252ecfff8fca5f1646c","0x4a7af46bc8abc00048c6c7920a1488daf568366c","0x66dcd42e6314b287110922ae36cb2a8bdeecc153","0xc3cbfbaab532a04e36b6f901d725eaa5113fd781","0xebc746a47ebb274de1dbdc9a465e6c5c2301c5da","0x868eed6bad4bd368cd053b766f84cc727697589a","0x2dbe0e264c7c246e05c6614794899937f264cf7b","0xbc461ef5225f1bbd2001eead75f56335aa781a69","0xc85d5cb72d1aad6f152a8decad228ae4a59ac9b3","0x7a33000372f3f028f074182ccb9d16cbeefbf920","0x2a430bebd2082d8e05d56d64dede8944279bbc24","0x880db7dda4407d99508574e680d067d1164b3cfe","0xd072410fa13d242e1d53721bcf7af02e3455dc96","0x7779415171077fa77568d9e1fb5c66e3ee03d9c2","0x16c70f04c3080a127486cdf5a4c33c066bbf47c3","0xc01c2800186207270ba5386532a8173c5b7dd194","0xf668e21993f0acd7ab00bb1cfbaed0df28a3c8ec","0x784e539f15ca2d19449a6311c5dab6cf37d8f1ba","0xa0473ced0cd1bfb857e3e04b5fa4b6af18c5e44d","0xce56168c09f4b7fca30523822c48008705c01156","0x4dbdcb087992404ea9b14fa83cc695b02797f39a","0x532e0f46d1e528507fc9454d5847c231f23bddf6","0xd448990883e3bf9cdd8ebca368a3ecf9d629aaf7","0xd0acf293547457fb4fe9ee32ca93e89497626816","0x0f21a72a02dc78217c2987826d061500aecf7707","0xdebaebe5b2729f7d62072b2ea40472d78d2c1626","0x792f465e0434fb1028ea3bfeb05240cb839c4e04","0x6eaec4f69c92bd16a4b018ceb6fe7a446a113598","0x2740c0faab738f6e346e545fde02aef9b1a01ee7","0xbb5507daae822ba89c4da61bbfdf4b49a1666bac","0x0cabc1f570fc7e80af454b5bc839b4014b4acfd1","0xe7030be388b8e247abe0c9fa876673e83fbcbd3c","0xf5fcb9cdafce67d50afef298f88e709d2b946ba6","0x042adaf267e0ddb89cd1b264a16ada127e0285ce","0xe6a7317df4a9a7540663b99a07d1e019caa8afa4","0x3eca1a7d881e12d2c7d8111269cea0bcbf12192a","0xf0844016f0e92099d3d56ee13c6a50df59e08781","0x5e3c5083f27654fac92126cb3fbd8773306cd90d","0x988b949de9d3a3d2172f22c19694c7a5148c9e87","0x3093ab396c617af17c7ce56fa19bf75e473315ee","0xf6c259eb2ac81e4269eb6159e921faebcaf0f4f0","0x6249af7ca9887b98cf7f2d9d42e8486fa3acfa37","0xdc65a7a69e1d647b12e87de6c1c7a84db80c0703","0xb305829bbb29f21f760c8ee23c021e603a2db416","0x138cb591c4a7d854d796e1906af8228d84cb7642","0xb35b5b3f17f4a780ec694202db704be4fc46e2f0","0xcc8c6092fb6aeddad8d55b95655a91c6c4cdc90c","0x351c957385e9fe0966eb9436ab7bc82918c30f54","0x5ca1da1ed90a6cf15974c0a0d2808bfde76314c1","0x52c53a3232c84cb17b05349d68c9fd75df549e03","0x27d352c10f906d6e3b89c652fe56214c64e02353","0x2e8b5774887b71e4f806b6d4d9e6eb26cc4d17da","0x9c8dbaefa1a13a6a20e4bbc56786bf5b2a65e6ba","0xbc9050d78d2d8d88f7536af49d4007aef469d7b4","0x0086bcba6ff176d7a478973c1ea86a0dcadff6e8","0x117ebaebebcdae05b29a1e4813ccb44303b48748"],"type":"string","description":"Aerodrome Slipstream pool address (lowercase hex) from /catalogue.json"},"staked":{"enum":["true","false"],"type":"string","description":"Hypothetical position staked in the gauge (AERO) or not (fees)"},"target":{"enum":["80","90","95"],"type":"string","description":"In-range target of the Q1 preset range"},"window_h":{"enum":["24","72","168","720"],"type":"string","description":"Look-back window in hours"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","answer","why","evidence","uncertainty","coverage","dataset","block_range","paused_build_intervals","answer_sha256"],"properties":{"why":{"type":"string","description":"Method and reasoning"},"pool":{"type":"string","description":"Q1: pool address the answer is about"},"pools":{"type":"array","items":{"type":"string"},"description":"Q2/Top 5: pool addresses in the answer"},"answer":{"type":"string","description":"Human-readable result"},"status":{"enum":["ANSWERED"],"type":"string"},"dataset":{"type":"object","description":"dataset_sha256, data_cutoff_utc, schema and calc versions"},"product":{"type":"string"},"coverage":{"type":"object","description":"expected/actual/missing/stale hours and coverage_pct"},"evidence":{"type":"object","description":"Pool, block range, observation counts, source contracts"},"query_id":{"type":"string"},"block_range":{"type":"object","required":["from_block","to_block","from_hour_utc","to_hour_utc"],"properties":{"method":{"type":"string"},"to_block":{"type":["integer","null"]},"from_block":{"type":["integer","null"]},"to_hour_utc":{"type":"integer"},"from_hour_utc":{"type":"integer"}},"description":"Exact Base block range of the answer window: first block with timestamp >= from_hour_utc to last block before to_hour_utc"},"uncertainty":{"type":"string"},"answer_sha256":{"type":"string","description":"sha256 of the canonical answer bytes; GET /v1/archive/{answer_sha256} returns them (free, 30 days)"},"paused_build_intervals":{"type":"array","items":{"type":"object","required":["from_hour_utc","to_hour_utc"],"properties":{"to_hour_utc":{"type":"integer","description":"slot in which builds resumed (exclusive)"},"from_hour_utc":{"type":"integer","description":"first missed hourly build slot"},"missed_builds":{"type":"integer"},"first_build_after_utc":{"type":"integer"},"last_build_before_utc":{"type":"integer"}}},"description":"UTC hour slots where the hourly build did not run, overlapping the answer window; [] when none"}}}}}}},"responseSchema":{"type":"json","example":{"why":"<method id and rule>","pool":"<pool address>","answer":"<pair> staked 1000 USDC in ticks [<lower>, <upper>) over the last <window_h> h: gross_estimate <x> USDC (range <lo>..<hi>), state ESTIMATED, before gas. estimate for a hypothetical position, not realised return, not advice.","status":"ANSWERED","dataset":{"dataset_sha256":"<64 hex>","schema_version":"aero-1","data_cutoff_utc":"<unix>"},"product":"position_yield","coverage":{"stale_hours":"<int>","actual_hours":"<int>","coverage_pct":"<number>","missing_hours":"<int>","expected_hours":"<int>"},"evidence":{"range":{"tick_lower":"<int>","tick_upper":"<int>"},"position":{"staked":true,"notional_usdc":1000}},"query_id":"<20 hex>","block_range":{"method":"base_2s_from_anchor","to_block":"<int>","from_block":"<int>","to_hour_utc":"<unix>","from_hour_utc":"<unix>"},"uncertainty":"<stated limits>","answer_sha256":"<64 hex>","paused_build_intervals":["<{from_hour_utc, to_hour_utc, missed_builds, ...}>"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_H3dSKa1X4SsUNvzr-J3QU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical on-chain yield evidence and gross yield estimates for a concentrated-liquidity position in a specific Aerodrome Slipstream pool on Base over a given time window.","exampleAgentPrompt":"What's the estimated gross yield for a 1000 USDC staked position in Aerodrome pool 0x422df9aa896e883c9cdcbad309c0785b7364a1cf over the last 48 hours? I want the on-chain evidence with coverage stats.","exampleUseCases":[{"title":"LP profitability check before rebalancing","prompt":"I'm thinking of rebalancing my concentrated liquidity position in Aerodrome pool 0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2 — can you pull the historical yield evidence for the last 72 hours so I can see how much a 1000 USDC staked position would have grossed?"},{"title":"DeFi yield research across Aero pools","prompt":"I'm comparing Aerodrome pools on Base for yield farming — can you get me the position yield evidence for pool 0x42609aa1e58c5dd7e5a012dc74118fff975f0eac over the last 168 hours so I can see coverage, data quality, and gross estimate?"},{"title":"Verifiable yield audit with on-chain proof","prompt":"I need auditable on-chain evidence of yield for Aerodrome pool 0x2836e062a3fe75943a7f4a552e2365b98e414e75 over the past 24 hours — give me the SHA256 hash, block range, and gross USDC estimate for a 1000 USDC notional position."}],"resultDescription":"Returns a JSON object containing: a natural-language answer with gross yield estimate and range, pool address, status (ANSWERED/etc.), a dataset object with SHA256 and schema version, coverage metrics (actual hours, expected hours, coverage percentage, stale hours), evidence with tick range and position details, block range with from/to block numbers and UTC timestamps, uncertainty statement, and a unique query ID with SHA256 hash of the answer.","failureModes":["Pool address not in supported enum — returns error or no data","Requested window_h exceeds available data coverage — low coverage_pct returned","Data stale beyond threshold — stale_hours field will be high","Payment not processed via x402 — 402 Payment Required before data is returned","Missing required query parameters (pool, window_h, target) — 400 Bad Request","Paused build intervals cause gaps — reflected in paused_build_intervals array and missing_hours"],"whenToPreferThis":"Use this endpoint when you need cryptographically verifiable, on-chain-backed yield evidence for Aerodrome Slipstream concentrated liquidity pools on Base, particularly when you need audit trails (SHA256), data quality/coverage metrics, or are comparing hypothetical position returns across multiple Aero pools. Prefer this over generic DeFi analytics when you need structured evidence with uncertainty bounds and block-level provenance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:53:48.202Z","isFirstParty":false,"canonicalSlug":"acepilot-position-yield-aerodrome-pool-historical-yield-evidence-e79e9d54"}