Data Sources and Provenance
Where the figures come from, how prices and volumes are formed, and what the API says when it does not know.
Where the Data Comes From
| Source | What it provides | Where you see it |
|---|---|---|
| Canton trading venues | Tickers, pool state, order books, trades and candles, read every 30 seconds to 5 minutes depending on what each venue allows. AMM venues such as Cantex and Tradecraft, order-book venues such as Temple, Kora and Rocky. | /v1/venues, /v1/markets, /v1/pools |
| Centralised exchange references | Canton Coin's USD price is the median of three exchange references (Bybit CC/USDT, OKX CC/USDT and Kraken CC/USD, the USDT legs converted at Kraken's USDT/USD rate). | Canton Coin's quotes.USD, conversions |
| The Digital Asset registry | Total supply as an approved registrar reports it, and the instrument's registry configuration. | total_supply, /supply/historical, /registry-configurations |
| CantonCap review | Issuer profiles, descriptions, links and logos, published only after review. | /v1/issuers, asset description and links |
The authoritative list of venues, with what each one publishes, is GET /v1/venues and each venue's capabilities.
How the Figures Are Formed
Reference Price
Each asset's reference price is recalculated about once a minute, in each currency the API publishes, from the prices public Canton venues quote for it: each market's ticker, or its pool state where a market publishes no ticker. A price quoted in another asset (a stablecoin, Canton Coin) is converted through that asset's own reference price, so no stablecoin is assumed to be worth exactly one dollar. A quote counts only within bounds on liquidity, distance from its peers, spread, price impact, conversion steps and age, and no single venue can move the result beyond a cap. last_updated_at on a quote is the time the price was calculated.
FDV
fdv is the exact product of the price and the total supply an approved registrar reported, as known when the price was calculated. When that supply is missing, older than the accepted age (24 hours by default) or withdrawn, fdv is null. History is never revalued: a past point keeps the FDV of its own moment.
Market Capitalisation
market_cap is null for every asset. It needs a circulating supply, and no reviewed circulating-supply methodology exists for Canton instruments. FDV is never substituted for it.
Volume
An asset's 24-hour volume is the best available measurement: the venue's own reported aggregate or the volume observed in its trades, never their sum. quotes.*.volume.method says which (reported or trades) and volume.coverage how complete the observations were. In activity measurements, venue-reported USD and USD derived from exchange prices are kept in separate fields.
Liquidity, Depth and the Liquidity Score
An AMM pool's liquidity is the USD value of its reserves at their reference prices; a reserve without a price leaves the figure null. An order book is measured by its depth. Depth within 2% is read from the book's own levels on an order book and modelled from stored pool state, fee included, on an AMM (depth_origin tells which). The liquidity score rates a market from 0 to 100 by the price impact of simulated buys and sells of $100 to $10,000, fees excluded; a market without enough inputs has no score, which is not a score of zero.
Rank and Ratios
rank orders every listed asset by its FDV, pool liquidity and rolling 24-hour volume, once over the whole listing, so it is the same in every currency, sort and page. liquidity_to_fdv_ratio divides pool liquidity by FDV, and volume_24h_to_fdv_ratio the selected 24-hour volume by FDV; each carries its coverage and is null when FDV is missing, stale or zero.
The full methodology, with the bounds and the reasoning, is published at cantoncap.cc/methodology.
What a Public Figure Carries
A public figure carries its value, its time and, where it is a sum over observations, its coverage and method. It does not carry its audit trail: the constituent list, venue weights, exclusion reasons and calculation run are recorded by CantonCap but are not part of the public API. What you can reconstruct publicly is the spread across venues: GET /v1/assets/market-pairs/latest returns every market an asset trades in with its own price, which you can compare with the reference price.
404 without saying whether it exists.Source Availability
GET /v1/status/sources answers, for each venue, whether its feed is operational (available) and when it last measured data (last_updated_at). A lagging or degraded feed still counts as available; authentication failures, a disabled feed or another operational failure make it unavailable. The last data a source delivered may remain readable while it is unavailable, with its old timestamps. For the state of the service as a whole, see cantoncap.cc/status.