# AcePilot Position Yield — Aerodrome Pool Historical Yield Evidence

> AcePilot Position Yield — Aerodrome Pool Historical Yield Evidence is a paid API for AI agents from aeroacepilot.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

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.

## Facts

- Endpoint: GET https://aeroacepilot.xyz/v1/position-yield?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acepilot-position-yield-aerodrome-pool-historical-yield-evidence-e79e9d54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HA00DGXdjGXEPv7sFSStD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability acepilot-position-yield-aerodrome-pool-historical-yield-evidence-e79e9d54
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Historical on-chain evidence for Aero pools on Base. Compare query purposes, prices and availability before paying with x402 USDC.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
        "0x
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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, ...}>"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acepilot-position-yield-aerodrome-pool-historical-yield-evidence-e79e9d54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aeroacepilot.xyz](https://www.zero.xyz/host/aeroacepilot.xyz/llms.txt)