INTEGRATE · IN BUILD

Read API

Read-only, unauthenticated, aggregates first. No endpoint on this surface can write, and none returns personal data. Versioned; breaking changes get a new major.

Version

Rate limit

60/min/ip

Freshness

≤3600s

CORS

Endpoint	Returns	Status
/api/v1/public/ledger/circulation	Circulating total per asset, with its honesty state	IN BUILD
/api/v1/public/ledger/invariant	The last invariant run, or null if it has never run	IN BUILD
/api/v1/public/ledger/assets	The asset registry and each asset's decimals	IN BUILD
/api/v1/public/ledger/entries	Anonymised entries, paginated	NORTH STAR

Every response carries its own honesty state

{
  "asset": "FG",
  "circulation": "84203915.0000",
  "state": "reported",
  "invariant": { "last_run": null, "result": null },
  "as_of": "2026-08-14T04:00:00Z"
}

The state field is not cosmetic. An integrator rendering our figures inherits our honesty state, which is the point: nobody downstream can present a Reported figure as Reconciled without actively discarding a field.