API

The full fwa.fun index as plain JSON.

Want access?

DM for an API key and higher rate limits.

Base URL

https://data.fwa.gg/v1

Responses cache at the edge for a few seconds, so poll politely. Data comes from the fwa.fun core contract on Ethereum mainnet; timestamps are unix seconds, ETH values are decimal numbers. For an API key, DM @hovwtf.

Endpoints

GET/pool

Pool-wide lifetime totals: backing locked, volume, ETH/$FWA paid out, kept value, keep rate, LP fees, depositor + ripper counts, top pulls.

GET/livepulls?limit=40

Most recent resolved pulls, newest first, with collection names, backing, exit type, payout, ripper and tx hash.

GET/series?days=90&bucket=d

Daily time-series (bucket d|w|m): pulls, volume, ETH/$FWA out, kept value, exit split, deposits staged.

GET/rippers?limit=100&window=1d

Top purchasers. window: all, 30m, 1h, 8h, 1d, 3d, 7d, 30d.

GET/wallets?sort=backing&limit=100

Depositor leaderboard. sort: backing | earned | pulls.

GET/collections?limit=50

Collections ranked by pulls served, with on-chain names and volume.

GET/collection?a=0x…&days=7

Collection detail: lifetime and windowed stats, backing histogram, recent and top pulls, top rippers.

GET/board?limit=50

The live prize board: active listings ranked by backing, with collection names and depositors.

GET/wallet?a=0x…

Full wallet profile: lifetime stats, leaderboard ranks, recent activity as ripper and as depositor.

GET/search?q=milady

Search wallets (address) and collections (name or address).

GET/stats

$FWA market data: USD/ETH price, 24h change, liquidity, volume (via DexScreener).

GET/pulse

Indexer heartbeat: chain head, backfill progress, totals.

Example

curl https://data.fwa.gg/v1/rippers?window=1h

{ "items": [ { "wallet": "0x…", "pulls": 42,
    "ethOut": 1.93, "fwaOut": 12094.2,
    "kept": 1, "keptValue": 0.12 } ],
  "window": "1h" }