Skip to content
1 minute readAPIAgent-ready

Every price says what kind of claim it is

Every price the API returns now carries a kind, so an agent can tell an estimate from a signed commitment and a listing from a sale, and the vocabulary defines the nine kinds and the one shape every price shares.

A price is only useful once you know who stands behind it and whether money moved. The API now says so on every price it returns.

  • compute_price and the photo price check answer kind: computed, an estimate by a pricing function; a signed_quote carries kind: quoted, a commitment Last Price honours until it expires
  • The vocabulary at /.well-known/lastprice-vocabulary.json defines nine kinds of price (list, floor, ceiling, offer, agreed, settled, observed, computed, quoted) with who speaks each one and how binding it is
  • The shape every price shares is published as a JSON Schema at /.well-known/price-statement.schema.json: a computed price must carry a confidence, a quoted price an expiry, a settled price a settlement time
  • Product price lookups now keep listings and sales apart in the product library too, so a sold dataset is never read as asking prices