# AcePilot — Aero Range Compare (aeroacepilot.xyz)

> AcePilot — Aero Range Compare (aeroacepilot.xyz) is a paid API for AI agents from aeroacepilot.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-01).

Compares query purposes, prices, and availability for historical on-chain range evidence across multiple Aerodrome Slipstream pools on Base, before payment is committed.

## Facts

- Endpoint: GET https://aeroacepilot.xyz/v1/grains/range/compare?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acepilot-aero-range-compare-aeroacepilot-xyz-10d475a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dp3laRDvmdlTT8Gc21yhB

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-aero-range-compare-aeroacepilot-xyz-10d475a8
```

Example prompt: Before I pay anything, can you compare the available query purposes, prices, and availability for historical range evidence on the Aerodrome USDC/ETH pool (0x422df9aa896e883c9cdcbad309c0785b7364a1cf) over a 24-hour window on AcePilot?

## When to prefer this

Use this endpoint when you need to compare the cost, purpose, and availability of multiple Aerodrome Slipstream pool range queries on Base before committing payment. It is the discovery/preview step in a two-phase workflow: compare first here, then pay and retrieve via the specific grain endpoints. Prefer this over direct grain queries when you are cost-sensitive, have multiple pool options, or need to verify data availability before spending USDC via x402.

## Known failure modes

- Invalid or unsupported pool address returns an error or empty result
- Missing required query parameters (pool, ranges, window_h) causes a 400-level error
- Pool address not in the supported enum list is rejected
- Window outside available historical data range returns no data
- Payment not completed via x402 before calling results in 402 Payment Required
- Network or RPC issues on Base chain may cause delayed or unavailable data

## 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 payload containing grain metadata (grain_id: grain_range_compare), answer state (ANSWERED or otherwise), available query metrics per purpose, pricing, and availability flags for the requested pool and ranges. Includes a JCS-RFC8785-v2 canonicalized SHA-256 integrity hash for verifying the response.

## 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",
      "ranges",
      "window_h"
     ],
     "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": {
  "payload": {
   "answer": {
    "state": "ANSWERED",
    "metrics": {}
   },
   "grain_id": "grain_range_compare",
   "schema_version": "grain-2"
  },
  "delivery": {
   "product": "grain_range_compare"
  },
  "integrity": {
   "answer_sha256": "<64 hex>",
   "canonicalization": "jcs-rfc8785-v2"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acepilot-aero-range-compare-aeroacepilot-xyz-10d475a8/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)
