Market prices
Informational USD quotes with their source and observation time.
Supported scope
The backend supports Kraken and CoinGecko for exact mainnet BTC, ETH, TRX and the two registered USDT assets. USD only; test assets and arbitrary currency pairs are unsupported. USDT is not automatically treated as one dollar.
Reading a quote
Always check asset, price, source name, provider time, retrieval time and stale status. Fetching an old price again does not make it fresh. If all eligible quotes are expired, the result explicitly has stale=true.
Fresh quotes take precedence over stale ones, followed by configured priority and source time. No eligible quote means unavailable pricing, not a zero price.
Shared installation settings
A separate price worker refreshes a shared PostgreSQL cache. Every organization reads the same market observations through its authorized API; reading a quote does not call a provider or require the worker to be online. If refresh stops, stored observations keep their real timestamps and become explicitly stale.
Provider endpoints, update intervals, maximum age, priority and enabled state are installation-wide operator settings. Tenant administrators cannot edit providers through the API. Reading quotes or provider status requires prices.read and current feature availability. Changing provider configuration excludes old-version quotes until refreshed; no eligible quote means unavailable pricing.
These price and feature controls are not integrated into the current console. Organization preferences can disable price availability, but cannot override the installation’s global disable. No permission or production deployment is implied by this guide.
Recorded historical observations — API only
The backend now retains accepted public observations, including exact price, source/configuration version, provider time and first retrieval time. Repeated unchanged observations keep the original record. Provider changes do not rewrite previous evidence.
Authorized history reads return bounded pages over at most 31 days. Past-instant selection considers only observations first retrieved by that time; missing history is unavailable, not a zero price or a substitution of today’s quote. The stale flag on a past-instant result refers to that instant.
These endpoints require prices.read and current price availability. They have no console controls yet. History starts when the current worker records observations; there is no automatic historical backfill or refund calculation. Explicit frozen accounting valuation and period closure are separate protected API operations; this console has no controls for them.
Usage limits
A quote is not accounting revaluation, an executable exchange rate or Workflow/signing authority. Prices do not change the Ledger or guarantee an amount obtainable in a market.