REST API
Read pools, tokens, swaps, and positions as JSON.
Base URL: https://hyperpools.dev/api/v1.
APP=https://hyperpools.dev
curl -fsS "$APP/api/v1/openapi.json"Endpoints
All paths below are relative to /api/v1.
| Path | Query contract |
|---|---|
/status | no query parameters; current public status |
/deployments | no query parameters; accepted deployment inventory |
/disclosure | no query parameters; versioned public disclosure |
/incidents | no query parameters; latest 100 incidents |
/pools | version, limit, cursor; exact lookup also needs poolId |
/tokens | limit+cursor, or paired indexedBlock and indexedBlockHash |
/swaps | version, pool, limit, cursor |
/positions | required owner; optional version, pool, limit, cursor |
/positions/v2/{pairAddress} | required owner |
/positions/v3/{tokenId} | optional exact owner check |
/positions/v4/{tokenId} | optional exact owner check |
/hook-shares | required owner; optional poolId, limit, cursor |
/hook-shares/{poolId}/{owner} | no query parameters |
/reports/proposal | days=30 or days=90 |
/openapi.json | no query parameters |
Request and response behavior
Successful bodies use { "data": ..., "meta": ... }. Paginated bodies may include nextCursor.
Limits
The API does not support historical block arguments, subscriptions, batching, USD prices, TVL, fee accounting, candles, position valuation, or beneficial ownership.