CantonCap API

Market data for the Canton Network over one REST API: reference prices, listings, candles, venues, pools, order books, activity and issuers, as exact decimal strings.

The CantonCap API serves the market data behind cantoncap.cc: reference prices for Canton assets, ranked listings, OHLCV candles and price history, every venue, market, pool and order book we observe, rolling activity, global metrics and curated issuer profiles. There are 35 read endpoints over HTTPS and an authenticated WebSocket for live updates.

QuickstartA key, a first request in cURL, JavaScript or Python, and how to read the answer.API ReferenceEvery endpoint with its parameters, an example response and every field.Track an AssetResolve an asset's ID, then read its price, FDV, volume and changes.Decimals and PrecisionWhy every figure is a string, and how to keep all of its digits.

Base URL

Text

https://api.cantoncap.cc/v1

Every public operation is a GET under /v1, answers in JSON, and needs an API key in the X-API-Key header. Requests without a valid key are refused with 401.

A First Request

The ten largest assets by fully diluted valuation, priced in US dollars:

curl -s "https://api.cantoncap.cc/v1/assets/listings/latest?convert=USD&sort=fdv&limit=10" \
  -H "X-API-Key: $CANTONCAP_API_KEY"

No key yet? Choose a plan on cantoncap.cc/api; the Quickstart walks through the rest.

What the API Promises

Exact numbers. Prices, amounts, volumes and ratios are decimal strings, never JSON floats, so no digit is lost on the way. Decimals and precision.
Stated absences. A value the API cannot stand behind is null, never a zero and never an estimate. market_cap is null for every asset because no reviewed circulating-supply methodology exists. Data sources and provenance.
Its own timestamps. Every quote and observation carries last_updated_at, so you decide how old is too old. Responses.
A contract. The reference is generated from the OpenAPI document the API is built and tested against, and you can download it. Changelog and versioning.

Endpoint Groups

Group	What it covers	Endpoints
Simple	Convenience price lookups.	1
Assets	Canonical assets, listings, prices, and history.	11
Markets	Venue markets, observations, books, trades, and candles.	7
Pools	AMM pool state, liquidity, and read-only quotes.	2
Venues	Venue metadata, capabilities, and market coverage.	4
Activity	Stored volume and execution-count history.	2
Global	Cross-market CantonCap metrics.	3
Status	Data availability and freshness.	1
Issuers	Curated issuers, evidence, and linked assets.	4