Docs / Reference

Buys feed JSON

Every VVV and SEED buy our sales make on Base, as a public file. What each field means and how the dollars are counted.

The files

GET https://super-seeder.com/buys/data/buys.json
GET https://super-seeder.com/buys/data/epoch-32.json

Written every 5 minutes. Each buy is checked against its transaction on Base: only transactions that succeeded are listed, at the time of their block. Proof of demand reads these files from your browser; so can you. They are served with Cache-Control: max-age=60.

buys.json holds the totals, one entry per week and the last 50 buys. epoch-NN.json holds every buy of one week, where NN is the AntSeed epoch.

What counts as a buy

Kind Buys Paid with
Sweep VVV USDC settled by sales
Participants SEED, paid to the people who sell their idle credit VVV
SEED back SEED, sent back to buyers VVV
Stakers SEED and DIEM, for the people staking SEED VVV
Launch SEED, the first buy, in the launch transaction VVV

Every buy goes through the open market at its price, like anyone else's, so each one is part of the demand for VVV and SEED. The VVV that buys SEED and DIEM was bought by sweeps first. That is why the VVV and SEED totals are kept apart: adding them would count the same dollars twice. The split behind each kind is on Tokenomics.

This feed lists what sales buy. The pool's fee, swapped in part to DIEM when a staking week closes, is listed with that week on Stake.

Shape

{
  "schema": 1,
  "generated_at": 1795206847,
  "epoch": {"genesis": 1775728461, "seconds": 604800, "current": 32},
  "n": 187,
  "n_src": {"sweep": 170, "participants": 10, "seed_back": 6, "stakers": 0, "launch": 1},
  "amt_src": {"sweep": 195.518141, "participants": 932108.9, "seed_back": 79198.0, "stakers": 0.0, "launch": 283692551.118281},
  "degraded": [],
  "tokens": {
    "VVV":  {"n": 170, "amt": 195.518141, "paid": 4456.02, "usd": 4456.02, "n_unpriced": 0, "first_ts": 1788481547},
    "SEED": {"n": 17, "amt": 284703858.025399, "paid": 186.481823, "usd": 4037.16, "n_unpriced": 0, "first_ts": 1795048849}
  },
  "launch": {"n": 1, "amt": 283692551.118281, "paid": 182.696761, "usd": 3961.14, "n_unpriced": 0, "ts": 1795048849},
  "gas": {"usd": 1.8958, "n_unpriced": 0, "launch": 0.104055},
  "last_24h": {"n": 16, "tok": {"VVV": {"n": 3, "amt": 3.399602, "paid": 73.25, "usd": 73.25, "n_unpriced": 0}}},
  "weeks": [
    {"ep": 32, "start": 1795082061, "n": 18,
     "counts": {"participants": {"SEED": 10}, "seed_back": {"SEED": 4}, "sweep": {"VVV": 4}},
     "tok": {"VVV": {"n": 4, "amt": 4.498738, "paid": 98.58, "usd": 98.58, "n_unpriced": 0}},
     "has_launch": false, "fp": "53763c45f96a"}
  ],
  "last": [
    [1795206619, "participants", "SEED", 98516.4, 0.36, 0.0000731, 0.0045, 7.2, "0x…"]
  ]
}
Field Meaning
generated_at when the file was written, Unix seconds (UTC)
epoch the AntSeed epochs used for weeks: week n starts at genesis + n × seconds, every Thursday at 09:54 UTC
n, n_src, amt_src how many buys, in all and by kind, and the amount bought by kind
degraded empty when every source is current; prices when hourly prices are late, chain when buys are waiting to be confirmed. The page then shows the time of the file instead of LIVE
tokens per token bought: count, amount received (amt), amount paid (paid, in USDC for VVV and in VVV for the rest), dollars (usd) and how many buys have no dollar value yet (n_unpriced)
launch the launch buy on its own; it is included in tokens
gas the gas of every buy, in dollars; launch is the part that is the fee of the whole launch transaction
last_24h the same counts for the last 24 hours
weeks[].counts buys per kind and token in that week, launch included
weeks[].tok per token, the week's totals without the launch buy, which is the size of months of buying; has_launch says the week holds it
weeks[].fp a fingerprint of the week's buys; it changes when the week's file changes, so epoch-NN.json?v=<fp> is always the matching file
last the 50 newest buys

Rows

Each buy, in last and in epoch-NN.json ({"schema": 1, "ep": 32, "rows": [...]}), is one array:

[time, kind, token, amount, paid, price, gas, usd, tx]
Position Meaning
time the block time, Unix seconds (UTC)
kind sweep, participants, seed_back, stakers or launch
token VVV, SEED or DIEM
amount what the transaction received
paid what it paid: USDC for a sweep, VVV for the rest
price dollars per token received
gas the transaction fee, in dollars; for the launch buy, the fee of the whole launch transaction
usd dollars spent, without the gas
tx the transaction hash; open it on Basescan

How the dollars are counted

  • Sweeps are in USDC, so their dollars are exact: usd is the USDC paid and the price is USDC per VVV. Their gas is the fee on the receipt, or the transaction fee at the ETH price of the hour when the receipt has none.
  • SEED and DIEM are paid in VVV. Their dollars are that VVV at the VVV price of the hour: the last hourly price up to 2 hours before the buy, otherwise the first one up to 2 hours after. Their gas is the fee at the ETH price of the same hour.
  • A missing price is never a zero. Without an hourly price the buy has null in price and usd, and it is counted in n_unpriced instead of in the dollars. A total with no priced buy at all is null, not 0. Hourly prices usually arrive within the hour, so a buy priced with the previous hour can move a little when its own hour lands.

Last updated 2026-11-20 · this page as Markdown · llms.txt