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:
usdis 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
nullinpriceandusd, and it is counted inn_unpricedinstead of in the dollars. A total with no priced buy at all isnull, not0. Hourly prices usually arrive within the hour, so a buy priced with the previous hour can move a little when its own hour lands.