CAMPAIGN: The timed query sale has ended. List prices apply. Query routes (including /v1/check, Q1/Q2/Top 5/position-yield, Open Query, Q1 batch, grains and analytics) use the live discounted 402 amount. Credit packs and pay=yield invoices stay at full / invoice price. Raffle: More than 10 successful paid queries during the 48-hour half-price window (from 7 Nov 2026 00:00 to 9 Nov 2026 00:00 Europe/Helsinki). The earlier flash window does not count. /v1/check counts; credit-pack purchases and pay=yield invoice payments do not. Prize: 100 basic-form + 10 multi-form queries for one random qualifier after the window. Details: /docs/CAMPAIGN.md and GET /v1/campaign. Live x402 amounts, /catalogue.json prices and credit quotes already include the active discount. Always trust the 402 amount before paying. # AcePilot > AcePilot sells on-chain range evidence for Aero (ex-Aerodrome) Slipstream concentrated-liquidity pools on Base. Call GET /v1/q1?pool=&window_h=&target= and pay the x402 challenge (USDC on Base, exact scheme), or pay with prepaid credits. The /v1/check preflight costs 0.001 USDC (x402 or 1 GC in credits); free only with an invited developer key. Pool addresses are listed in /catalogue.json. Refused or stale queries return 4xx/503 before any payment is requested. Every answer names its pool(s), the exact Base block range and any paused hourly builds (paused_build_intervals, [] when none); GET /v1/archive/{answer_sha256} (free, 30 days) returns the canonical answer bytes so sha256 can be checked. ## Paid endpoints (x402, USDC on Base) - GET https://aeroacepilot.xyz/v1/q1 ($0.04): Concentrated-liquidity range evidence for one Aerodrome Slipstream pool on Base: the narrowest price range that stayed in range for a target share (80/90/95 %) of the last 24-720 h, with in-range %, out-of-range episodes, hourly coverage and block-level evidence from on-chain observations. Useful when choosing or re-centring an LP range. Refused or stale queries return 4xx/503 before any payment. - GET https://aeroacepilot.xyz/v1/q2 ($0.08): Best current Aerodrome Slipstream pools on Base for a new concentrated-liquidity allocation: up to three pools with a computed price range, in-range % over 72 h and 168 h, oor_hours and coverage, all from on-chain observations with dataset hash. Useful when selecting where to open a new LP position. - GET https://aeroacepilot.xyz/v1/top5 ($0.12): Top five Aerodrome Slipstream concentrated-liquidity pools on Base ranked by range stability (model RM-range-1): width %, in-range %, measured hours and coverage per pool over 168 h, from on-chain observations with dataset hash. Useful for a quick shortlist of stable CL pools. - GET https://aeroacepilot.xyz/v1/position-yield ($0.01): Estimated fee, AERO-emission and price-vs-HODL decomposition for a hypothetical 1,000 USDC concentrated-liquidity position (Q1 preset range, staked or unstaked) in one Aerodrome Slipstream pool on Base over the last 24-720 h. Each figure has state, method, coverage and low/high bounds; gross estimate before gas, never annualised. Estimate for a hypothetical position, not realised return, not advice. - GET https://aeroacepilot.xyz/v1/open ($0.19 + 0.09 * n): Structured Open Query on one Aerodrome Slipstream pool on Base over the last 24-720 h: coverage, narrowest 90 % range, swaps, volume, pool-level fees generated (all LPs, not an LP yield), staked-liquidity ratio or hourly tick path, each with measurement state, coverage and block range. Optional n = 0-10 evidence records recompute the metric on equal sub-windows. Price 0.19 + 0.09 * n USDC. - GET https://aeroacepilot.xyz/v1/q1-batch ($0.036 * pools): Q1 range evidence for 2-10 Aerodrome Slipstream pools on Base in one paid call (0.036 USDC per pool): each element is the same answer as /v1/q1 (narrowest range for the target, in-range %, coverage, block range, answer_sha256). All pools must be answerable or nothing is requested. Useful when comparing or re-centring several LP ranges. - GET https://aeroacepilot.xyz/v1/grains/pool-facts ($0.009): Pool Facts data grain for one Aerodrome Slipstream pool on Base at one pinned, quorum-anchored block: identity (stable id, factory, tokens, decimals, tick spacing), spot tick, sqrtPriceX96 and decimal price, active and staked liquidity with unstaked remainder, staked share and fee configuration. Each field labelled MEASURED or DERIVED, with coverage, block hash and an answer_sha256 archived for 30 days. Hourly cache; refused before payment if incomplete. - GET https://aeroacepilot.xyz/v1/grains/range/boundary-distance ($0.003): Boundary distance data grain: for a caller-supplied tick range on one Aerodrome Slipstream pool on Base, the tick and price-% distance from the latest pinned spot tick to each boundary and whether spot is inside. Point fact from the hourly cache with block reference and answer_sha256; not a forecast, not advice. Invalid or unaligned ticks return 400 before payment. - GET https://aeroacepilot.xyz/v1/grains/range/in-range ($0.01): In-range data grain: for a caller-supplied tick range on one Aerodrome Slipstream pool on Base over the last 24, 72 or 168 h, known, all-in, out-of-range and unknown hours and the observed in-range fraction from the on-chain close-tick path. Coverage must reach 90 % or the query is refused before payment. Hourly cache, grain-2 hashed envelope. - GET https://aeroacepilot.xyz/v1/grains/activity ($0.024): Activity data grain bundle for one Aerodrome Slipstream pool on Base over 24/72/168 h: swap count, per-token volume (raw and whole units) and pool-level generated fees (not LP income), from on-chain cumulative counters with counted and excluded hours listed. Refused before payment below 90 % hourly coverage. Archived by answer_sha256. - GET https://aeroacepilot.xyz/v1/grains/range/diagnostics ($0.04): Range Diagnostics data grain bundle for a caller-supplied tick range on one Aerodrome Slipstream pool on Base over 24/72/168 h: in-range hours and fraction, in/out episodes with censor flags, boundary distance at the pinned spot, observed tick width and hourly realized variation. Every component needs 90 % coverage or the bundle is refused before payment. Historical description, not a forecast. - GET https://aeroacepilot.xyz/v1/grains/evidence-check ($0.003): Evidence Check data grain bundle for one Aerodrome Slipstream pool on Base over 24/72/168 h: coverage manifest (tick-path, flow, pinned-state and gauge-tape hours against the 90 % rule, paused builds) and a reproducibility receipt (dataset hash and table digests, method hashes, quorum-anchored blocks, checks performed and not performed, recheck recipe). Useful before relying on any AcePilot answer. - GET https://aeroacepilot.xyz/v1/grains/evidence/hours ($0.004): Hour Ledger data grain for one Aerodrome Slipstream pool on Base over 24/72/168 h (0.004 USDC): one row per hour with tape state, observation count and timestamps, exact Base block range, how the hour was read (live or recovered after a paused build) and whether the pinned state sample was live or quorum-backfilled. Provenance for verifiers and LVR/backtest pipelines; gaps are listed, never filled. Archived by answer_sha256. - GET https://aeroacepilot.xyz/v1/grains/liquidity-history ($0.006): Liquidity History data grain for one Aerodrome Slipstream pool on Base over 24/72/168 h (0.006 USDC): hourly active and staked liquidity at pinned blocks with the staked share, plus min/median/max and change. For risk monitors and dashboards watching liquidity leave or concentrate. Refused before payment below 90 % sampled hours. - GET https://aeroacepilot.xyz/v1/grains/price-history ($0.008): Price History data grain for one Aerodrome Slipstream pool on Base over 24/72/168 h (0.008 USDC): hourly tick open, high, low and close from the on-chain sampled close-tick path with exactly derived prices, unknown hours left null. For charts, backtests and agents that need a verifiable price path. Refused before payment below 90 % coverage. - GET https://aeroacepilot.xyz/v1/grains/epoch/report ($0.012): Epoch Report data grain for one Aerodrome Slipstream pool on Base for the previous or current Aero epoch (Thursday 00:00 UTC weeks; 0.012 USDC): swaps, per-token volume and generated fees, fees in USDC at cutoff TWAP prices, average staked share and an ESTIMATED staked-liquidity fee share shown with its inputs. For veAERO voters and incentive buyers deciding where votes and bribes go each epoch. Refused before payment below 90 % flow coverage. - GET https://aeroacepilot.xyz/v1/grains/pair-compare ($0.015): Pair Compare data grain (0.015 USDC): every universe pool trading the same token pair as the given pool side by side: tick spacing, fee configuration, active liquidity, staked share, spot price oriented to the given pool, divergence in bps and 168 h activity. For LPs choosing a fee tier and routers checking sibling pools. Refused before payment if the pair has no sibling pool. - GET https://aeroacepilot.xyz/v1/grains/universe/pool-facts ($0.05): Universe Pool Facts data grain (0.05 USDC): pool facts (identity, spot, active and staked liquidity, staked share, fee configuration) for every AcePilot universe pool on Aerodrome Slipstream in one answer, each with its single-pool answer hash. For dashboards and agents that would otherwise make one call per pool. Archived by answer_sha256. - GET https://aeroacepilot.xyz/v1/grains/universe/activity ($0.06): Universe Activity data grain over 24/72/168 h (0.06 USDC): swaps, per-token volume and generated fees for every universe pool, fees in USDC at cutoff TWAP prices, ranked; pools under 90 % coverage or without prices are excluded and listed. For screeners, dashboards and allocators. Generated fees are pool-level, not LP income. - GET https://aeroacepilot.xyz/v1/grains/epoch/leaderboard ($0.035): Epoch Leaderboard data grain (0.035 USDC): all universe pools ranked by fees generated in the previous or current Aero epoch (USDC at cutoff TWAP prices), with average staked share and an ESTIMATED staked-liquidity fee share per pool; excluded pools listed with reasons. For veAERO voters and bribers comparing where fees are produced. A fee ranking, not a voting-return ranking; bribes are not included. - GET https://aeroacepilot.xyz/v1/grains/universe/anomalies ($0.03): Anomaly Scan data grain (0.03 USDC): every universe pool's last 24 h against its prior 144 h baseline: swaps and fees per hour, median active liquidity and price move, with flags against fixed published thresholds. For risk agents polling hourly. Flags are statistical deviations, not evidence of manipulation or trade signals. - GET https://aeroacepilot.xyz/v1/grains/range/compare ($0.02): Range Compare data grain (0.02 USDC): two to five caller tick ranges on one Aerodrome Slipstream pool classified on the same 24/72/168 h on-chain close-tick grid: all-in hours, observed fraction, in and out runs, longest run and width. For LP agents choosing between candidate ranges. Refused before payment below 90 % coverage. - GET https://aeroacepilot.xyz/v1/grains/range/watch ($0.002): Range Watch data grain (0.002 USDC per poll, 2 GC with credits): status of one caller tick range on one Aerodrome Slipstream pool: in range now, distance to both boundaries, last 24 h in-range hours, hours since the last exit and flags (out_of_range_now, near_boundary, exited_last_24h). Built for LP bots polling every hour. Hourly cache, not live. - GET https://aeroacepilot.xyz/v1/grains/price-correlation ($0.005): Price Correlation data grain (0.005 USDC): Pearson correlation and beta of hourly log returns between two universe pools over 24/72/168 h from on-chain close ticks, with joint-hour coverage. For hedging and portfolio agents. Historical association, not a forecast. Refused before payment below 90 % joint coverage. Example: GET https://aeroacepilot.xyz/v1/q1?pool=0x042adaf267e0ddb89cd1b264a16ada127e0285ce&window_h=168&target=90 ## Payment options - pay=flat (default): the x402 price above, paid up front - pay=yield: Optional pay=yield on q1, q2, open (default pay=flat): q1 3 %, q2 5 %, open 8 % of the committed position's gross accrual over 30 days, invoiced afterwards over x402 (terms 2026-10-31). GET ?&pay=yield -> 428 COMMITMENT_REQUIRED with the terms and EIP-712 type (nothing charged); resend with the signed commitment in X-AcePilot-Yield-Commitment -> 200 answer (same bytes as pay=flat) + X-AcePilot-Agreement-Id; after the agreement period GET /v1/invoice/ -> x402 402 for the share due. - pay=yield definitions (terms 2026-10-31, https://aeroacepilot.xyz/docs/YIELD-SHARE-TERMS.md sections 2a-2b): accrual starts at the first Base block at or after the agreement start (time the answer is served) and ends at the first block at or after start + 30 days; the billing basis is the committed position's liquidity L = the lowest liquidity inside the committed ticks among the start block, every 24 h checkpoint and the end block (path minimum, never higher than min(L at start, L at end)), not a USDC principal; agreements signed under terms 2026-10-30 keep L = min(L at start block, L at end block); liquidity added during the period is never billed, liquidity removed reduces L; a position burned, transferred or changing staked status before the end goes to manual review with no automatic invoice; a position left at zero liquidity accrues nothing and owes nothing. ## Prepaid credits (optional) - GET https://aeroacepilot.xyz/v1/credits/packs/1?accept_terms=credits-2026-10-31 ($1): 1000 GC for the paying wallet - GET https://aeroacepilot.xyz/v1/credits/packs/5?accept_terms=credits-2026-10-31 ($5): 5500 GC for the paying wallet (+10 %) - GET https://aeroacepilot.xyz/v1/credits/packs/20?accept_terms=credits-2026-10-31 ($20): 24000 GC for the paying wallet (+20 %) - Terms credits-2026-10-31: NON-REFUNDABLE; credits expire 12 months after purchase (oldest pack spent first); no cash-out; no transfer; not a token. https://aeroacepilot.xyz/docs/CREDITS-TERMS.md - 1 GC = 0.001 USDC list price: every answer costs its listed flat USDC price in credits (Q1 0.04 USDC = 40 GC); no price changes. - Spend: GET https://aeroacepilot.xyz/v1/credits/quote?url= (free) -> sign the returned EIP-712 CreditSpend with the paying EOA (fresh 32-byte nonce, expiry <= 300 s) -> repeat the paid GET with header X-AcePilot-Credits: base64(JSON {message, signature}). Refusals, bad or stale signatures are never debited; the same nonce re-serves without a second debit. - Balance (free, zero for unknown wallets; total + next expiry only): GET https://aeroacepilot.xyz/v1/credits/balance?wallet=<0x>; lots and ledger need X-AcePilot-Credits signed by that wallet for GET /v1/credits/balance (maxUnits 0, never debits). Free lookups: ~30/min per client, then 429 + Retry-After ## Which call to make - One pool, one range question: /v1/q1. Several pools (re-centring or comparing 2-10 LP ranges): /v1/q1-batch, 10 % cheaper per pool. - Fees, swaps, volume, staked ratio or tick path of a pool, with optional per-sub-window evidence: /v1/open. - Fee/emission decomposition for the Q1 range (ESTIMATED, labelled, not realised return): /v1/position-yield. - Single data grains (grain-2 envelope, MEASURED/DERIVED labels, per-component 90 % coverage, answer_sha256 over JCS): pool facts 0.009, boundary distance 0.003 and in-range 0.01 for your own tick range, activity 0.024, range diagnostics 0.04, evidence check 0.003, hour ledger 0.004, liquidity history 0.006, price history 0.008, epoch report 0.012, pair compare 0.015, range compare 0.02, range watch 0.002 per poll, price correlation 0.005; universe-wide: pool facts 0.05, activity 0.06, epoch leaderboard 0.035, anomaly scan 0.03; all under /v1/grains/. Refusals (grain-error-1) come before any 402 and are never charged. - Every paid 200 carries a Link header (rel=related) to the matching follow-up calls. - No preflight needed: invalid, refused (coverage) and stale requests are rejected before any 402 and never charged. /v1/check (would this exact query be answered, price, coverage) is a paid preflight: 0.001 USDC via x402 or 1 GC in credits; free only with an invited developer key (header X-AcePilot-Dev-Key). - Chained calls on one dataset: add dataset_sha256=<64 hex> (or header X-AcePilot-Dataset) to any paid answer route (q1, q2, top5, open, q1-batch, position-yield, grains). Every 402 and paid 200 carries the live hash in header X-AcePilot-Dataset-Sha256. If the live dataset changed, the call returns 409 DATASET_CHANGED with only the current dataset_sha256 and data_cutoff_utc and nothing is charged (checked before any x402 payment, credit debit or pay=yield commitment); a match or no pin behaves as before. Old builds are never served. ## Query patterns (79, all live; details: catalogue.json "patterns" and https://aeroacepilot.xyz/docs/QUERY-PATTERNS.md) - 1. Pool universe and prices: GET https://aeroacepilot.xyz/catalogue.json [free] - 2. Freshness check: GET https://aeroacepilot.xyz/health [free] - 3. Check-then-pay preflight (Q1): GET https://aeroacepilot.xyz/v1/check?product=q1&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 4. Preflight a batch price: GET https://aeroacepilot.xyz/v1/check?product=q1_batch&pools=0x422df9aa896e883c9cdcbad309c0785b7364a1cf,0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&window_h=168&target=90 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 5. Preflight an Open price: GET https://aeroacepilot.xyz/v1/check?product=open&metric=fees_generated&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=720&n=4 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 6. Preflight a grain (no answer leak): GET https://aeroacepilot.xyz/v1/check?product=grain_in_range&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=-281200&tick_upper=-279200&window_h=168 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 7. Archive verification (sha256 == id): GET https://aeroacepilot.xyz/v1/archive/ [free] - 8. Reading paused_build_intervals: GET https://aeroacepilot.xyz/v1/check?product=q1&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 9. Related follow-ups (cross-sell map): GET https://aeroacepilot.xyz/v1/check?product=top5 [preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key). Without a key: standard x402 402 (amount 1000) or 1 GC with X-AcePilot-Credits; unknown products are refused (400) before any 402.] - 10. Q1 weekly baseline (168 h / 90 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 11. Q1 short-term tight range (24 h / 80 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=24&target=80 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 12. Q1 conservative wide range (72 h / 95 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=72&target=95 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 13. Q1 monthly regime (720 h / 90 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=720&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 14. Multi-window scan (24/72/168/720 at 90 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=24&target=90 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=72&target=90 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=720&target=90 [flat 4 x 0.04] (optional preflight 0.001 USDC; free only with an invited developer key) - 15. Target sweep (80/90/95 at 168 h): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=80 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=95 [flat 3 x 0.04] (optional preflight 0.001 USDC; free only with an invited developer key) - 16. Correlated majors baseline (WETH/cbBTC): GET https://aeroacepilot.xyz/v1/q1?pool=0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 17. Stable vs BTC baseline (USDC/cbBTC): GET https://aeroacepilot.xyz/v1/q1?pool=0x42609aa1e58c5dd7e5a012dc74118fff975f0eac&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 18. Tokenized equity baseline (USDC/SNDKc): GET https://aeroacepilot.xyz/v1/q1?pool=0x2836e062a3fe75943a7f4a552e2365b98e414e75&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 19. Tokenized equity baseline (USDC/MUc): GET https://aeroacepilot.xyz/v1/q1?pool=0x41e21950362b1014bc629252ecfff8fca5f1646c&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 20. Blue-chip pool baseline (WETH/USDC): GET https://aeroacepilot.xyz/v1/q1?pool=0x4a7af46bc8abc00048c6c7920a1488daf568366c&window_h=168&target=90 [flat 0.04 or pay=yield 3 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 21. Q1 with deferred payment (pay=yield, 3 %): GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90&pay=yield [pay=yield 3 % (post-hoc invoice)] (optional preflight 0.001 USDC; free only with an invited developer key) - 22. Seed-pool batch (3 pools): GET https://aeroacepilot.xyz/v1/q1-batch?pools=0x422df9aa896e883c9cdcbad309c0785b7364a1cf,0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2,0x42609aa1e58c5dd7e5a012dc74118fff975f0eac&window_h=168&target=90 [flat 0.036 x 3 = 0.108] (optional preflight 0.001 USDC; free only with an invited developer key) - 23. Head-to-head (2 pools): GET https://aeroacepilot.xyz/v1/q1-batch?pools=0x4a7af46bc8abc00048c6c7920a1488daf568366c,0x42609aa1e58c5dd7e5a012dc74118fff975f0eac&window_h=72&target=90 [flat 0.072] (optional preflight 0.001 USDC; free only with an invited developer key) - 24. Top-10 universe scan: GET https://aeroacepilot.xyz/v1/q1-batch?pools=0x422df9aa896e883c9cdcbad309c0785b7364a1cf,0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2,0x42609aa1e58c5dd7e5a012dc74118fff975f0eac,0x2836e062a3fe75943a7f4a552e2365b98e414e75,0x41e21950362b1014bc629252ecfff8fca5f1646c,0x4a7af46bc8abc00048c6c7920a1488daf568366c,0x66dcd42e6314b287110922ae36cb2a8bdeecc153,0xc3cbfbaab532a04e36b6f901d725eaa5113fd781,0xebc746a47ebb274de1dbdc9a465e6c5c2301c5da,0x868eed6bad4bd368cd053b766f84cc727697589a&window_h=168&target=90 [flat 0.36] (optional preflight 0.001 USDC; free only with an invited developer key) - 25. Tokenized-equity basket: GET https://aeroacepilot.xyz/v1/q1-batch?pools=0x2836e062a3fe75943a7f4a552e2365b98e414e75,0x41e21950362b1014bc629252ecfff8fca5f1646c,0x66dcd42e6314b287110922ae36cb2a8bdeecc153,0xebc746a47ebb274de1dbdc9a465e6c5c2301c5da&window_h=168&target=80 [flat 0.144] (optional preflight 0.001 USDC; free only with an invited developer key) - 26. New allocation (Q2): GET https://aeroacepilot.xyz/v1/q2 [flat 0.08 or pay=yield 5 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 27. Q2 then archive proof: GET https://aeroacepilot.xyz/v1/q2 then GET https://aeroacepilot.xyz/v1/archive/ [flat 0.08 (archive free)] (optional preflight 0.001 USDC; free only with an invited developer key) - 28. Q2 with deferred payment (pay=yield, 5 %): GET https://aeroacepilot.xyz/v1/q2?pay=yield [pay=yield 5 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 29. Top 5 concentrated pools: GET https://aeroacepilot.xyz/v1/top5 [flat 0.12 only] (optional preflight 0.001 USDC; free only with an invited developer key) - 30. Top 5 vs Q1 sanity check: GET https://aeroacepilot.xyz/v1/top5 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 [flat 0.12 + 0.04] (optional preflight 0.001 USDC; free only with an invited developer key) - 31. Top 5 then batch ranges: GET https://aeroacepilot.xyz/v1/top5 then GET https://aeroacepilot.xyz/v1/q1-batch?pools=<5 pools from Top 5>&window_h=168&target=90 [flat 0.12 + 0.18] (optional preflight 0.001 USDC; free only with an invited developer key) - 32. Top 5 with archive proof: GET https://aeroacepilot.xyz/v1/top5 then GET https://aeroacepilot.xyz/v1/archive/ [flat 0.12 (archive free)] (optional preflight 0.001 USDC; free only with an invited developer key) - 33. Position yield, staked (gauge emissions): GET https://aeroacepilot.xyz/v1/position-yield?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90&staked=true [flat 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 34. Position yield, unstaked (LP fees): GET https://aeroacepilot.xyz/v1/position-yield?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90&staked=false [flat 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 35. Stake-or-not comparison: GET https://aeroacepilot.xyz/v1/position-yield?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90&staked=true then GET https://aeroacepilot.xyz/v1/position-yield?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90&staked=false [flat 2 x 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 36. Per-pool position yield (WETH/cbBTC): GET https://aeroacepilot.xyz/v1/position-yield?pool=0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&window_h=168&target=90&staked=true [flat 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 37. Open coverage (168 h): GET https://aeroacepilot.xyz/v1/open?metric=coverage&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 38. Open range (168 h): GET https://aeroacepilot.xyz/v1/open?metric=range&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 39. Open swaps (24 h): GET https://aeroacepilot.xyz/v1/open?metric=swaps&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=24&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 40. Open volume (168 h): GET https://aeroacepilot.xyz/v1/open?metric=volume&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 41. Open fees_generated (720 h): GET https://aeroacepilot.xyz/v1/open?metric=fees_generated&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=720&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 42. Open tick_path (168 h): GET https://aeroacepilot.xyz/v1/open?metric=tick_path&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 43. Open staked_ratio (168 h): GET https://aeroacepilot.xyz/v1/open?metric=staked_ratio&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0 [flat 0.19 or pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 44. Open time series (n = 10 sub-windows): GET https://aeroacepilot.xyz/v1/open?metric=fees_generated&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=720&n=10 [flat 0.19 + 0.09 x 10 = 1.09] (optional preflight 0.001 USDC; free only with an invited developer key) - 45. Open daily breakdown (n = 7): GET https://aeroacepilot.xyz/v1/open?metric=swaps&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=7 [flat 0.19 + 0.09 x 7 = 0.82] (optional preflight 0.001 USDC; free only with an invited developer key) - 46. Open with deferred payment (pay=yield, 8 %): GET https://aeroacepilot.xyz/v1/open?metric=fees_generated&pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&n=0&pay=yield [pay=yield 8 %] (optional preflight 0.001 USDC; free only with an invited developer key) - 47. Settle a pay=yield invoice: GET https://aeroacepilot.xyz/v1/invoice/ [x402 for the share due] - 48. Pool facts: GET https://aeroacepilot.xyz/v1/grains/pool-facts?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf [flat 0.009] (optional preflight 0.001 USDC; free only with an invited developer key) - 49. Boundary distance for my range: GET https://aeroacepilot.xyz/v1/grains/range/boundary-distance?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=-281200&tick_upper=-279200 [flat 0.003] (optional preflight 0.001 USDC; free only with an invited developer key) - 50. Hourly range monitor: GET https://aeroacepilot.xyz/v1/grains/range/boundary-distance?pool=0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&tick_lower=-266674&tick_upper=-264674 [flat 0.003 per call] (optional preflight 0.001 USDC; free only with an invited developer key) - 51. Backtest my range (in-range): GET https://aeroacepilot.xyz/v1/grains/range/in-range?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=-281200&tick_upper=-279200&window_h=168 [flat 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 52. Short-window in-range check (24 h): GET https://aeroacepilot.xyz/v1/grains/range/in-range?pool=0x42609aa1e58c5dd7e5a012dc74118fff975f0eac&tick_lower=-67500&tick_upper=-65500&window_h=24 [flat 0.01] (optional preflight 0.001 USDC; free only with an invited developer key) - 53. Pool activity (swaps, volume, fees): GET https://aeroacepilot.xyz/v1/grains/activity?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168 [flat 0.024] (optional preflight 0.001 USDC; free only with an invited developer key) - 54. Activity regime shift (24 h vs 168 h): GET https://aeroacepilot.xyz/v1/grains/activity?pool=0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&window_h=24 then GET https://aeroacepilot.xyz/v1/grains/activity?pool=0xec3c3755b9ded4a2960ef50c9b48c1694ce274c2&window_h=168 [flat 2 x 0.024] (optional preflight 0.001 USDC; free only with an invited developer key) - 55. Range diagnostics bundle: GET https://aeroacepilot.xyz/v1/grains/range/diagnostics?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=-281200&tick_upper=-279200&window_h=168 [flat 0.04 (separate grains would cost 0.053)] (optional preflight 0.001 USDC; free only with an invited developer key) - 56. Q1 range stress test: GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 then GET https://aeroacepilot.xyz/v1/grains/range/diagnostics?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=&tick_upper=&window_h=72 [flat 0.04 + 0.04] (optional preflight 0.001 USDC; free only with an invited developer key) - 57. Evidence check before trusting a pool: GET https://aeroacepilot.xyz/v1/grains/evidence-check?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168 [flat 0.003] (optional preflight 0.001 USDC; free only with an invited developer key) - 58. Pool due diligence pack: GET https://aeroacepilot.xyz/v1/grains/pool-facts?pool=0x2836e062a3fe75943a7f4a552e2365b98e414e75 then GET https://aeroacepilot.xyz/v1/grains/activity?pool=0x2836e062a3fe75943a7f4a552e2365b98e414e75&window_h=168 then GET https://aeroacepilot.xyz/v1/grains/evidence-check?pool=0x2836e062a3fe75943a7f4a552e2365b98e414e75&window_h=168 [flat 0.009 + 0.024 + 0.003 = 0.036] (optional preflight 0.001 USDC; free only with an invited developer key) - 59. Grain archive verification: GET https://aeroacepilot.xyz/v1/grains/pool-facts?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf then GET https://aeroacepilot.xyz/v1/archive/ [flat 0.009 (archive free)] (optional preflight 0.001 USDC; free only with an invited developer key) - 60. Refusal-aware retry: GET https://aeroacepilot.xyz/v1/grains/activity?pool=0xc3cbfbaab532a04e36b6f901d725eaa5113fd781&window_h=24 [flat 0.024 only if answered] (optional preflight 0.001 USDC; free only with an invited developer key) - 61. Read the credit terms and packs: GET https://aeroacepilot.xyz/v1/credits [free] - 62. Buy a 1 USDC credit pack (1,000 GC): GET https://aeroacepilot.xyz/v1/credits/packs/1?accept_terms=credits-2026-10-31 [flat 1 (non-refundable prepaid credits)] - 63. Buy a 5 USDC credit pack (5,500 GC, +10 %): GET https://aeroacepilot.xyz/v1/credits/packs/5?accept_terms=credits-2026-10-31 [flat 5 (non-refundable prepaid credits)] - 64. Buy a 20 USDC credit pack (24,000 GC, +20 %): GET https://aeroacepilot.xyz/v1/credits/packs/20?accept_terms=credits-2026-10-31 [flat 20 (non-refundable prepaid credits)] - 65. Check a wallet's credit balance and expiry: GET https://aeroacepilot.xyz/v1/credits/balance?wallet=0x0000000000000000000000000000000000000001 [free] - 66. Spend credits on a Q1 answer: GET https://aeroacepilot.xyz/v1/credits/quote?url=%2Fv1%2Fq1%3Fpool%3D0x422df9aa896e883c9cdcbad309c0785b7364a1cf%26window_h%3D168%26target%3D90 then GET https://aeroacepilot.xyz/v1/q1?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168&target=90 [40 GC from credits (= flat 0.04)] (optional preflight 0.001 USDC; free only with an invited developer key) - 67. Hour-by-hour evidence ledger: GET https://aeroacepilot.xyz/v1/grains/evidence/hours?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168 [flat 0.004] (optional preflight 0.001 USDC; free only with an invited developer key) - 68. Liquidity history: GET https://aeroacepilot.xyz/v1/grains/liquidity-history?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&window_h=168 [flat 0.006] (optional preflight 0.001 USDC; free only with an invited developer key) - 69. Hourly price history (OHLC): GET https://aeroacepilot.xyz/v1/grains/price-history?pool=0x4a7af46bc8abc00048c6c7920a1488daf568366c&window_h=168 [flat 0.008] (optional preflight 0.001 USDC; free only with an invited developer key) - 70. Weekly epoch report: GET https://aeroacepilot.xyz/v1/grains/epoch/report?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&epoch=previous [flat 0.012 per pool per epoch] (optional preflight 0.001 USDC; free only with an invited developer key) - 71. Sibling pool comparison: GET https://aeroacepilot.xyz/v1/grains/pair-compare?pool=0x4a7af46bc8abc00048c6c7920a1488daf568366c [flat 0.015] (optional preflight 0.001 USDC; free only with an invited developer key) - 72. Universe pool facts (all pools): GET https://aeroacepilot.xyz/v1/grains/universe/pool-facts [flat 0.05] (optional preflight 0.001 USDC; free only with an invited developer key) - 73. Universe activity screen: GET https://aeroacepilot.xyz/v1/grains/universe/activity?window_h=24 [flat 0.06] (optional preflight 0.001 USDC; free only with an invited developer key) - 74. Epoch fee leaderboard: GET https://aeroacepilot.xyz/v1/grains/epoch/leaderboard?epoch=previous [flat 0.035] (optional preflight 0.001 USDC; free only with an invited developer key) - 75. Anomaly scan: GET https://aeroacepilot.xyz/v1/grains/universe/anomalies [flat 0.03 per scan] (optional preflight 0.001 USDC; free only with an invited developer key) - 76. Compare candidate ranges: GET https://aeroacepilot.xyz/v1/grains/range/compare?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&ranges=-282000:-278000,-281000:-279000,-280500:-279500&window_h=168 [flat 0.02 (2-5 ranges)] (optional preflight 0.001 USDC; free only with an invited developer key) - 77. Range watch (hourly position alert): GET https://aeroacepilot.xyz/v1/grains/range/watch?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&tick_lower=-282000&tick_upper=-278000 [flat 0.002 per check] (optional preflight 0.001 USDC; free only with an invited developer key) - 78. Price correlation vs a benchmark pool: GET https://aeroacepilot.xyz/v1/grains/price-correlation?pool=0xc85d5cb72d1aad6f152a8decad228ae4a59ac9b3&benchmark=0x4a7af46bc8abc00048c6c7920a1488daf568366c&window_h=168 [flat 0.005] (optional preflight 0.001 USDC; free only with an invited developer key) - 79. Weekly voter workflow: GET https://aeroacepilot.xyz/v1/grains/epoch/leaderboard?epoch=previous then GET https://aeroacepilot.xyz/v1/grains/epoch/report?pool=0x422df9aa896e883c9cdcbad309c0785b7364a1cf&epoch=previous [flat 0.035 + 0.012 per pool] (optional preflight 0.001 USDC; free only with an invited developer key) ## Analytics suite (data and analytics only; flat USDC prices; x402 or prepaid credits) - Terms: Data and analytics only: historical and point-in-time descriptions of public on-chain Aerodrome Slipstream data on Base. Not investment, financial, legal or tax advice; no recommendation to buy, sell or provide liquidity; no promise or estimate of returns; no custody of funds. Prices are shown in the 402 before any payment; a refused or stale request is never charged. Credits keep their own terms (non-refundable, docs/CREDITS-TERMS.md). - /v1/watch/range (0.005 USDC) for LP keeper bots and position managers polling a range every hour: Hourly range monitor for one caller range: in range now, tick and price distance to each boundary, edge proximity label, current in/out run and last-24 h in-range hours. Example: GET https://aeroacepilot.xyz/v1/watch/range?pool=0x042adaf267e0ddb89cd1b264a16ada127e0285ce&tick_lower=-887250&tick_upper=887250 - /v1/watch/portfolio (0.004 * positions USDC) for vaults, treasuries and multi-position LP managers: The range monitor for 2-20 caller ranges in one payment (pool:tick_lower:tick_upper separated by commas), 20 % under single calls. Example: GET https://aeroacepilot.xyz/v1/watch/portfolio?positions=0x042adaf267e0ddb89cd1b264a16ada127e0285ce:-887250:887250,0x08537fb017485dab8bdd9af3fb7d9cd56e98cb61:-887250:887250 - /v1/report/pool (0.06 USDC) for DAO treasuries, token teams, analysts and due-diligence desks: Pool due-diligence report in one call: identity, fee configuration, staked share, active liquidity, activity over 24/72/168 h, 168 h coverage manifest, observed tick width and hourly variation. Example: GET https://aeroacepilot.xyz/v1/report/pool?pool=0x042adaf267e0ddb89cd1b264a16ada127e0285ce - /v1/compare/pair (0.03 USDC) for LPs choosing between fee tiers (tick spacings) of the same pair: Every universe pool of one pair side by side: tick spacing, fee, staked share, 168 h swaps, per-token volume and generated fees, observed width. Ordered by tick spacing, not ranked. Example: GET https://aeroacepilot.xyz/v1/compare/pair?pair=AERO%2FUSDC - /v1/compare/pools (0.012 * pools USDC) for allocators and agents comparing candidate pools: 2-8 pools side by side over 24/72/168 h: fee, staked share, swaps, per-token volume, generated fees, observed width and hourly variation. Example: GET https://aeroacepilot.xyz/v1/compare/pools?pools=0x042adaf267e0ddb89cd1b264a16ada127e0285ce,0x08537fb017485dab8bdd9af3fb7d9cd56e98cb61&window_h=168 - /v1/screen (0.15 USDC) for allocators, research agents and dashboards filtering the pool universe: Filter the pool universe by token, minimum swaps, maximum fee and minimum staked share over 24/72/168 h; up to 25 matches in alphabetical order with the filtered values. A filter, not a ranking or recommendation. Example: GET https://aeroacepilot.xyz/v1/screen?token=WETH&window_h=24 - /v1/movers (0.08 USDC) for monitoring agents, newsletters and research desks (daily or hourly): What changed in the last 24 h across the universe: the 10 pools whose 24 h swap count deviates most from their own 168 h hourly average, and the 10 largest 24 h close-tick price moves. Historical description, not a signal. Example: GET https://aeroacepilot.xyz/v1/movers - /v1/regime (0.015 USDC) for range-sizing bots and risk monitors: Volatility regime of one pool: hourly log-return stdev and largest hourly move over 24 h and 168 h, observed width, and a descriptive label CALMER / SIMILAR / MORE_VOLATILE (24 h vs 168 h). Example: GET https://aeroacepilot.xyz/v1/regime?pool=0x042adaf267e0ddb89cd1b264a16ada127e0285ce - /v1/ladder (0.03 USDC) for LPs and strategy builders choosing a range width: Range-width ladder: for symmetric ranges of 1-100 tick spacings around the current spot tick, the hours the past close-tick path would have stayed in range over 24/72/168 h. Historical, not a forecast. Example: GET https://aeroacepilot.xyz/v1/ladder?pool=0x042adaf267e0ddb89cd1b264a16ada127e0285ce&window_h=168 - /v1/feed/universe (0.25 USDC) for dashboards, indexers and aggregators (hourly snapshot): Hourly snapshot of the whole pool universe in one call: spot tick and price, fee, staked share, active liquidity, sample age and 24 h swaps per pool, with per-pool coverage. Cheaper than buying the same pool facts one by one. Example: GET https://aeroacepilot.xyz/v1/feed/universe ## Free - https://aeroacepilot.xyz/catalogue.json : prices, payTo, input schemas, pool universe (alphabetical), terms, credit mechanics - https://aeroacepilot.xyz/health : ok / stale only - https://aeroacepilot.xyz/v1/archive/{answer_sha256} : canonical bytes of a past answer, sha256(bytes) == id, 30-day retention - https://aeroacepilot.xyz/openapi.json : OpenAPI 3.1 document - https://aeroacepilot.xyz/docs/QUERY-PATTERNS.md, https://aeroacepilot.xyz/docs/YIELD-SHARE-TERMS.md, https://aeroacepilot.xyz/docs/CREDITS-TERMS.md : public docs (text/markdown) ## Preflight (paid) - https://aeroacepilot.xyz/v1/check : preflight 0.001 USDC; free only with an invited developer key (header X-AcePilot-Dev-Key, keys issued individually). Without a key: standard x402 402 (amount 1000) or pay 1 GC with X-AcePilot-Credits ## Answer fields for verification - pool / pools: pool address(es) the answer is about - block_range: {from_block, to_block, from_hour_utc, to_hour_utc}: exact Base blocks of the answer window - paused_build_intervals: [{from_hour_utc, to_hour_utc, ...}] hourly builds that did not run in the window; always present, [] when none - answer_sha256: sha256 of the canonical answer bytes served by /v1/archive/{answer_sha256} - Paid 200 responses also carry headers X-AcePilot-Answer-Sha256 (= answer_sha256) and X-AcePilot-Archive (/v1/archive/{answer_sha256})