GraphQL conventions

​

Two queries per table

launchs(
  where: { currency: "INR", graduated: false }
  orderBy: "volumeQuote"
  orderDirection: "desc"
  limit: 20
  after: "<cursor>"
) {
  items { token symbol volumeQuote }
  pageInfo { hasNextPage hasPreviousPage startCursor endCursor }
  totalCount
}

​

Pagination

query Trades($token: String!, $after: String) {
  trades(where: { launch: $token }, orderBy: "timestamp", orderDirection: "desc", limit: 100, after: $after) {
    items { id type quoteAmount tokenAmount timestamp }
    pageInfo { hasNextPage endCursor }
  }
}

​

Filters

{
  holders(where: { launch: "0x...", balance_gt: "1000000000000000000000" }) {
    items { address balance }
  }
}

​

Currency codes

0x494e520000000000000000000000000000000000000000000000000000000000

import { stringToHex } from "viem";
const code = stringToHex("INR", { size: 32 }).toLowerCase();

code = "0x" + "INR".encode().ljust(32, b"\0").hex()

​

Relations

{
  launch(token: "0x...") {
    symbol currency
    currencyInfo { symbol tier vault lastRate }
    trades(orderBy: "timestamp", orderDirection: "desc", limit: 5) {
      items { type quoteAmount priceQuote timestamp }
    }
  }
}

​

Scalars and units

​

Semantics worth knowing

• trade.priceQuote is the execution price of that trade, quoteAmount / tokenAmount. launch.lastPriceQuote and the candles use the spot price after the trade: the curve’s spotPrice() recomputed from the event’s tokensSold and realQuote while the launch is on the curve, and the pool price derived from sqrtPriceX96 after graduation.
• A buy’s quoteAmount is the gross quote paid, fee included. A sell’s quoteAmount is the net quote received. fee is stored separately in both cases. For pool swaps fee is an estimate: the pool fee in pips applied to the input amount and converted to quote units.
• trade.trader is the transaction sender. The contract-level caller is normally the Router or the Factory.
• holder rows exclude the bonding curve, the Uniswap v4 PoolManager and the burn address, and rows are deleted when a balance reaches zero, so launch.holderCount equals the number of holder rows for that launch.
• vaultSnapshot reads vault.status() at the event’s block. When status() reverts because the oracle price is older than its stale limit, the same accounting is recomputed from vault.assets() and the last known rate, and the row is written with fresh: false.
• currency rows are seeded from the registry the first time any handler needs them and kept in sync by CurrencySet and RatePosted. The oracle may post codes the registry does not list; those land in rates without a currency row.
• On Robinhood Chain post-graduation swaps are not indexed (see how the data is produced). tradeCount, volumeQuote and the candles of a graduated launch cover its curve phase only there.

​

HTTP endpoints