> **Draft** — auto-generated by roll-doc on 2026-05-28. Review before treating as authoritative.

# lib/prices/ — Model price snapshots

Dated JSON snapshots of AI model list prices, used by `roll loop status` to compute per-cycle cost in both USD and native currency (CNY for pi/DeepSeek/Kimi).

## Files

| File | Contents |
|------|---------|
| `snapshot-2026-05-22.json` | Multi-vendor snapshot (Claude, GPT, Gemini, DeepSeek, Kimi, pi) |
| `snapshot-2026-05-23-deepseek.json` | DeepSeek-specific refresh |
| `snapshot-2026-05-23-kimi.json` | Kimi-specific refresh |

## Format

Each snapshot is a JSON object keyed by model ID:

```json
{
  "claude-opus-4-7": {
    "input_per_mtok": 15.0,
    "output_per_mtok": 75.0,
    "cache_write_per_mtok": 18.75,
    "cache_read_per_mtok": 1.5,
    "currency": "USD"
  }
}
```

CNY-priced models (pi, DeepSeek, Kimi) use `"currency": "CNY"`.

## Refresh

`prices_fetcher.py` fetches fresh snapshots from vendor pricing APIs and writes a new dated file here. Run via `roll prices refresh`.