# AcePilot — Aerodrome Liquidity History

> AcePilot — Aerodrome Liquidity History is a paid API for AI agents from aeroacepilot.xyz, paid per call via x402, $0.006/call, status unknown (last checked 2026-11-01).

Returns historical on-chain liquidity data for a specific Aerodrome (Aero) pool on Base over a given time window

## Facts

- Endpoint: GET https://aeroacepilot.xyz/v1/grains/liquidity-history?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acepilot-aerodrome-liquidity-history-d9f79ec6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7eU8vWQDVEKr-OJhn2G6d

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-aerodrome-liquidity-history-d9f79ec6
```

Example prompt: Pull the liquidity history for the Aerodrome pool at 0x422df9aa896e883c9cdcbad309c0785b7364a1cf over the last 24 hours so I can see how liquidity has shifted.

## When to prefer this

Choose this endpoint when you need verifiable, on-chain historical liquidity evidence for a specific Aerodrome pool on Base, especially when integrity/auditability matters (the SHA-256 + JCS canonicalization provides tamper-evident proofs). Best when you need to compare liquidity over a custom time window before executing a trade or making a DeFi strategy decision. Prefer over generic DEX analytics dashboards when you need machine-readable, pay-per-query data with cryptographic integrity.

## Known failure modes

- Invalid or unsupported pool address returns an error or empty result
- window_h parameter out of acceptable range causes a validation error
- Payment not received via x402 USDC results in a 402 Payment Required response
- Pool has insufficient historical data for the requested window
- Network or RPC issues querying on-chain Base data cause timeouts

## 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 structured JSON payload containing historical liquidity metrics for the requested Aerodrome pool, an answer state (e.g. ANSWERED), a grain identifier, schema version, delivery metadata, and an integrity hash (SHA-256) for verifying the response's authenticity via JCS canonicalization.

## 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"
     ],
     "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",
        "0xf5fcb9cdafce67d5
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payload": {
   "answer": {
    "state": "ANSWERED",
    "metrics": {}
   },
   "grain_id": "grain_liquidity_history",
   "schema_version": "grain-2"
  },
  "delivery": {
   "product": "grain_liquidity_history"
  },
  "integrity": {
   "answer_sha256": "<64 hex>",
   "canonicalization": "jcs-rfc8785-v2"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acepilot-aerodrome-liquidity-history-d9f79ec6/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)