Get started

Reference rates

Source

The published reference rates: one number per product per day, the median list price among providers publishing one.

text
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.