TachiDocs
On this page

Data model

Pairs, decimals and the fields of every Tachi price.

Concepts

How prices are signed, agreed and kept fresh.

1 min read 3 sections Testnet

Pairs

Pairs are written SYMBOL/KES and SYMBOL/USD, for example SCOM/KES. The KES/USD rate is published as KES/USD.

Decimals

Every price uses 8 decimals, so a stored value is a count of 10⁻⁸ units of the quote currency. decimals() always returns 8.

Fields

struct PriceData {

  • priceValue in units of 10⁻⁸ of the quote currency
  • statusOpen · Closed · Halted
  • observedAtOldest source observation. Judge freshness by this
  • publishedAtOldest node signature time
  • signersNumber of nodes that signed
  • roundCounts accepted reports from 1
  • sourcesFewest independent sources any signing node used
  • spreadBpsHighest minus lowest node price, in basis points

}

Tip

Judge freshness by observedAt, not publishedAt. It reflects when the market data was actually seen.

Something wrong or missing on this page? Tell us.