# Harpd Model Pricing Dataset

> Human-readable README for the canonical `llm-pricing` dataset. Companion to https://harpd.com/data/llm-pricing.json.

## What it is

One record per model with input/output token price, the official provider pricing page it was read from, and the date it was verified.

## How it is generated

One record per model: input and output token list prices, the official provider pricing page each price was read from, and the date it was verified. Source type is OFFICIAL_PRICING — every price is a public list price read from the provider's official page. Each record carries its own source URL and verification date.

- **Source type:** `OFFICIAL_PRICING`
- **Coverage:** Public list prices for the models Harpd tools cost out.
- **Methodology:** https://harpd.com/methodology/model-pricing/

## Update frequency

Re-verified against official provider pages; each record carries its own verification date.

## Schema

The record shape is described by the `schemaVersion` envelope and field documentation carried by https://harpd.com/data/llm-pricing.json.

- **JSON endpoint:** https://harpd.com/data/llm-pricing.json
- **CSV mirror:** https://harpd.com/data/llm-pricing.csv

## License

CC BY 4.0 — https://creativecommons.org/licenses/by/4.0/

## Citation

> Harpd. "Harpd Model Pricing Dataset." harpd.com/llm-pricing/ License: CC BY 4.0.

## Limitations

- This dataset contains public list prices only, read from official provider pricing pages. It does NOT include negotiated, contract, or API-tier pricing that providers do not publish.
- Prices are point-in-time and each record carries its own verification date; a record is only as current as its verification date. Re-verify before relying on it for spend decisions.
- Costs are list prices before provider discounts, volume tiers, or credits unless a specific note says otherwise. They are never live billing data.

## Methodology

How these numbers are produced is documented at https://harpd.com/methodology/model-pricing/.

## Reproduction

1. Fetch the pricing table: `curl https://harpd.com/data/llm-pricing.json`
2. Each record names the official provider pricing page it was read from and its verification date, so any price can be independently re-checked: open the record's source URL and compare the listed list price.
3. For the CSV mirror: `curl https://harpd.com/data/llm-pricing.csv`

## Attribution

Source: Harpd
Data licensed under CC BY 4.0: https://creativecommons.org/licenses/by/4.0/
Canonical page: https://harpd.com/llm-pricing/