GraphQL

Query indexed pools, swaps, tokens, and positions.

Endpoint: https://hyperpools.dev/api/graphql.

This public, read-only endpoint supports subgraph queries. Read Indexed data for coverage.

APP=https://hyperpools.dev
curl -fsS "$APP/api/graphql" \
  -H 'content-type: application/json' \
  --data '{"query":"{ pools(first: 1) { id version } }"}'

Supported schema

AreaSupported data
Pairs and poolsv2 pairs and v2/v3/v4 pools
Swaps and transactionsv2/v3/v4 history and relations
Positionsv2 LP balances plus v3/v4 range/liquidity
Hook evidenceofficial/source-backed hooks and bounded ordered evidence
Hook sharesDual hook-share balances, distinct from NFTs

IDs

  • Pair.id is a v2 pair address.
  • v2/v3 Pool.id is a contract address; v4 Pool.id is a PoolId.
  • Pool.poolId is the internal canonical bytes32 identity.
  • Swap.id is the transaction hash plus a canonical decimal log index.
  • v2 Position.id is the pair address and requires an owner filter.
  • v3/v4 position IDs are canonical decimal NFT token IDs.
  • HookShareBalance.id is v4:<PoolId>:<owner>.

Limits

The endpoint does not support historical block: arguments, subscriptions, batching, USD prices, TVL, fee APYs, candles, position valuation, or beneficial ownership.

On this page