# 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](/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](/docs/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](/stake/).

## Shape

```json
{
  "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](https://basescan.org) |

## 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._
