Indexer (GraphQL)

The protocol runs a Ponder indexer that follows every protocol contract from the deploy block and maintains the tables below. It is the right data source for anything historical or aggregate: acquisition history, auction bid logs, burn totals, referral ledgers. Current single values (the live bid, an auction's high bid) are better read from the chain directly, which the indexer necessarily lags by a block or so.

The indexer's full source lives in the public repo under indexer/: ponder.schema.ts defines the tables, src/index.ts the event handlers.

Endpoint

The GraphQL endpoint is deployment-configured, not a fixed public URL. The site's server reads it from the INDEXER_URL environment variable and queries it server-side only; the browser never talks to the indexer directly. To run your own instance, point the Ponder app at a mainnet RPC and it serves the standard Ponder GraphQL API at both / and /graphql (plus /health and /ready).

Ponder's GraphQL exposes each table twice: a singular field that takes the primary key (returnAuction(id: 5822), protocolCounter(id: "global")) and a pluralized connection with where / orderBy / orderDirection / limit arguments whose rows sit under items (returnAuctions(...) { items { ... } }).

Tables

Acquisitions and the live bid

Return auctions

Vault and Proofs

Fees and burns

Title auction

Referrals

Counters

Rows in the event-log tables are keyed <txHash>-<logIndex> unless noted; per-entity tables key on the natural id (punkId, traitId, tokenId, an address). Timestamps are unix seconds, amounts are wei, both serialized as strings in GraphQL responses.

Example queries

Headline protocol stats:

{
  protocolCounter(id: "global") {
    collectedCount
    vaultedCount
    clearedCount
    proofsMinted
    totalEthBurned
    totalTokensBurned
    totalSwapVolumeWei
    swapCount
  }
}

Open return auctions, soonest-ending first:

{
  returnAuctions(
    where: {settled: false}
    orderBy: "endsAt"
    orderDirection: "asc"
  ) {
    items {
      punkId
      targetTraitId
      reserveWei
      highBidWei
      highBidder
      endsAt
      extensions
    }
  }
}

Every Proof minted so far, in collection order, with current holders:

{
  proofs(orderBy: "sequence", orderDirection: "asc", limit: 111) {
    items {
      tokenId
      traitId
      punkId
      recipient
      currentOwner
      sequence
      mintedAt
    }
  }
}