> Source: https://vitna.ai/docs/api/v1/prices/rates
> Raw Markdown: https://vitna.ai/docs/api/v1/prices/rates.md
> Corpus index: https://vitna.ai/llms.txt
# Reference rates
The published [reference rates](../../../concepts/reference-rate.md): one number per
product per day, the median list price among providers publishing one.
```
GET /api/v1/rates
```
```bash
curl https://vitna.ai/api/v1/rates
```
## Response
```json
{
"rates": [ ... ],
"method": "...",
"rule": [
"A series exists for a product at least 3 distinct providers publish a confirmed price for on the day.",
"The rate is the median of those prices: the middle one, or the mean of the two middle ones, with the halfway case rounded up.",
"Arithmetic is exact, in whole millionths, which is the precision the record stores.",
"A price read once and not yet confirmed by a second read does not count.",
"A series is never restated. A day is published once, and a correction is a new row on a later day."
],
"isNot": [
"a price anyone can buy at",
"a volume-weighted average, since the record holds no volumes",
"a forecast"
],
"meta": { "generatedAt": "...", "source": "database", "count": 24 }
}
```
## The method travels with the numbers
`rule` and `isNot` are in the payload, not linked from it.
A benchmark whose method a reader has to go and find is one most readers will
use without reading. The whole claim being made here is that the rule is fixed
and checkable, so it is served where the numbers are read.
`isNot` is there because all three are things a reader could reasonably assume
about something called a reference rate, and none of them is true.
## Serving the snapshot
An instance that cannot read the published rates answers `200` with
`rates: null`, the `method` and `rule` still present, and a `note` pointing at
`https://vitna.ai/api/v1/rates`.
`null` rather than `[]`: an empty array would say no rates have ever been
published, which is a claim about the record rather than about this instance.
## Parameters
None.
## Caching
`public, max-age=60, stale-while-revalidate=3600`.