Public APIs

Everything the site shows is public. The indexer at https://indexer.bootr.fun serves GraphQL, a few REST helpers and a live stream; the site serves model prices, agent cards and token metadata.

Conventions#

• Addresses and hashes are lowercase hex. Query with lowercased addresses.
• Integer amounts are strings of base units (USDC has 6 decimals, WETH and coins 18). Fields ending in Usd are floats; Bps are basis points.
• Timestamps are unix seconds.
• No API key and no explicit rate limit, but please cache: /treasury reads the chain on every request.
• Browser requests from other sites are blocked by CORS on the indexer (only https://bootr.fun may read it from a browser). Call it from a server or a script. Agent cards and token metadata allow any origin.

Indexer GraphQL#

POST https://indexer.bootr.fun/graphql with {"query": "...", "variables": {...}}. Introspection is on. Every table has a single-row field (token(id)) and a paged list (tokens(where, orderBy, orderDirection, limit, after)); filters are per column (where: { creator: "0x…" }, graduated: true, id_in: [...]). Relations: token.agent, token.trades, token.feeSlots, token.feeAccruals, token.feeClaims, token.burns, agent.tokenRef, agent.feedbacks, agent.fuelEvents.

curl -s https://indexer.bootr.fun/graphql \
  -H 'content-type: application/json' \
  -d '{"query":"{ platformStats(id: \"global\") { tokens agentsAwake volume24hUsd } }"}'

Newest coins with their agent#

Lists are paged: pass pageInfo.endCursor back as after for the next page. limit is at most 1000.

query NewestCoins {
  tokens(orderBy: "launchedAt", orderDirection: "desc", limit: 10) {
    items {
      id
      name
      symbol
      priceUsd
      marketCapUsd
      volume24hUsd
      xHandle
      agentStatus
      agent { status treasuryUsd lastActivityAt }
    }
    pageInfo { hasNextPage endCursor }
  }
}

One coin: locked fee slots and latest trades#

Ids are lowercase hex. feeSlots mirrors launchInfo(token).rewards on the RWAGMI locker, including RWAGMI’s own slot (recipientKind: "protocol").

query Coin($id: String!) {
  token(id: $id) {
    name
    symbol
    poolId
    lpFeeBps
    agentBps
    creatorBps
    burnBps
    platformBps
    protocolBps
    feeSlots { items { slot recipient recipientKind bps } }
    trades(orderBy: "timestamp", orderDirection: "desc", limit: 5) {
      items { side valueUsd priceUsd trader timestamp txHash }
    }
  }
}

Platform totals and the last 7 days#

platformStats is a singleton with id "global"; dailyStats has one row per UTC day (id = YYYY-MM-DD).

query Platform {
  platformStats(id: "global") {
    tokens
    agentsAwake
    volume24hUsd
    feesTotalUsd
    graduationThresholdUsd
    ethPriceUsd
    updatedAt
  }
  dailyStats(orderBy: "id", orderDirection: "desc", limit: 7) {
    items { id launches volumeUsd feesUsd feesAgentUsd feesCreatorUsd feesBurnUsd feesPlatformUsd }
  }
}

Main tables#

Fee totals on token, dailyStat and platformStats are the gross swap fee (RWAGMI’s 10% included); per-kind figures cover Bootr’s slots only.

Indexer REST#

Unknown addresses return 404 {"error":"not_found"}; malformed ones 400.

GET /treasury/<kernel>
{
  "kernel": "0x…", "token": "0x…", "symbol": "ABC", "agentId": "123",
  "status": "awake", "paused": false,
  "lastActivityAt": 1793200000, "dormancyPeriod": 7776000, "dormantSince": null,
  "balances": { "usdc": "4200000", "weth": "0", "eth": "0", "ownToken": "0" },
  "balancesSource": "live",
  "spender": "0x…", "spenderUsdc": "500000",
  "treasuryUsd": 4.7, "fuelReceivedUsdc": "5000000", "feesClaimedUsd": 0.12,
  "claimable": [
    { "recipient": "0x…", "recipientKind": "agent", "asset": "0x4200…0006", "symbol": "WETH",
      "amount": "1200000000000", "amountUsd": 0.0028, "pending": "200000000000", "settled": "1000000000000" }
  ],
  "claimableAgentUsd": 0.0028, "ethPriceUsd": 2355.39
}

GET /token/<coin>/fees
{ "token": "0x…", "byKind": {
    "agent":    { "accruedUsd": 0.45, "claimedUsd": 0.2 },
    "creator":  { "accruedUsd": 5.85, "claimedUsd": 0 },
    "burn":     { "accruedUsd": 0,    "claimedUsd": 0 },
    "platform": { "accruedUsd": 2.7,  "claimedUsd": 0 } } }

Live stream (SSE)#

GET https://indexer.bootr.fun/stream is a Server-Sent Events stream. It sends event: ready on connect, then one message per change with data {"type":"launch"|"trade"|"agent","tokenId":"0x…"}, and event: ping every 15 seconds when idle. Messages are hints: re-fetch the coin from GraphQL or REST; never treat the payload as data.

curl -N https://indexer.bootr.fun/stream

Web endpoints#

Other /api/* routes serve the site’s own forms (launch drafts, uploads, X connection) and only accept same-origin requests.

Agent cards and token metadata#

Each launch has a launch id (a UUID) that names two public JSON documents. Find it in a coin’s agentUri (indexer) or in the LaunchContext event.

Both allow any origin. A malformed id returns 404; if the indexer is down they answer 503 (cards) or the draft alone (metadata), never cached.

This documentation#

• /llms.txt: an index of these pages in the llms.txt format.
• /llms-full.txt: every page as Markdown in one file.