vitna.ai/docs/api/v1/prices/markets Machine view
Raw .md llms.txt
> Source: https://vitna.ai/docs/api/v1/prices/markets
> Raw Markdown: https://vitna.ai/docs/api/v1/prices/markets.md
> Corpus index: https://vitna.ai/llms.txt

# Markets

Every [component class](../../../concepts/component-class.md) Vitna prices, with
counts and freshness. The index of the record.

```
GET /api/v1/markets
```

```bash
curl https://vitna.ai/api/v1/markets
```

## Response

```json
{
  "classes": [
    {
      "class": "model",
      "label": "Language models",
      "unit": "One successful task",
      "wired": true,
      "priceCount": 918,
      "skuCount": 230,
      "providerCount": 14,
      "freshestConfirmedAt": "2026-08-23T08:00:11.402Z",
      "stalestConfirmedAt": "2026-08-22T19:00:04.118Z",
      "anyStale": false
    }
  ],
  "meta": { "generatedAt": "...", "source": "database" }
}
```

## Fields

| Field | Meaning |
|---|---|
| `class` | The id to pass to `/markets/{class}/tape` |
| `label` | Human name |
| `unit` | What you are actually buying in this class |
| `wired` | Whether Vitna has live sources yet |
| `priceCount` | Priced cells, counting each dimension separately |
| `skuCount` | Distinct skus |
| `providerCount` | Distinct providers |
| `freshestConfirmedAt` | Most recent read in the class |
| `stalestConfirmedAt` | Oldest read in the class |
| `anyStale` | Whether any cell is past its cadence |

`priceCount` counts cells, not skus. A model publishing input, cached input and
output prices contributes three.

## Watch the pair of timestamps

`freshestConfirmedAt` alone is misleading: one source refreshing on schedule
keeps it current while everything else silently ages.
`stalestConfirmedAt` is the one that shows that, and `anyStale` is the
one-glance version.

## Empty classes appear here

A class with nothing priced is listed with zero counts, null timestamps and
`anyStale: false`, never dropped. There are two ways to be empty, and `wired`
tells them apart:

| `wired` | Zero counts mean |
|---|---|
| `false` | The class is registered and Vitna does not read it yet |
| `true` | Vitna reads the class, and no seller it reads prices anything in it today |

`video` is the second kind. Google shut down Veo 3.1 Preview on 2026-10-22, and
its pricing page dropped every per-second figure the class held, so all seven
skus were retired and their periods closed on the last read that priced them.
The source still reads the page every cycle: those reads are what closed the
periods, and a video price that comes back is a read that fails loudly rather
than one that passes as an empty page. The history of all seven stays at
[`/skus/{slug}/history`](sku-history.md).

`extraction` and `speech` were the first kind until 2026-09-10, when both were
wired. A class that answers with zeroes is a gap a reader can hold the record
to, and a class dropped from the answer is a gap only its authors know about.

## Parameters

None.

## Caching

`public, max-age=60, stale-while-revalidate=3600`.
Human Machine Shift+M