For developers

JSON API

Free, read-only, no key, CORS-open. Every response carries methodology_version and generated_at. Values are US dollars; the headline is also given as an exact string to preserve precision at quadrillion scale.

GET /api/v1/marketcap/latest

The current headline market cap, day-over-day change, income-approach cross-check, and per-constituent breakdown.

curl https://earthmarketcap.org/api/v1/marketcap/latest

GET /api/v1/marketcap/history

The full daily series. Append ?format=csv for a download.

curl https://earthmarketcap.org/api/v1/marketcap/history?format=csv

GET /api/v1/constituents

The constituent registry with each one's latest value, valuation method, update mode, double-count treatment, and source.

GET /api/v1/income-approach

The Gordon-growth capitalization cross-check: central value, the (r − g) sensitivity band, and the inputs.

GET /api/v1/status

Freshness: the latest snapshot date and how many constituents are live vs. carried from a prior value.

GET /api/v1/methodology

Methodology version and the load-bearing pillars in summary.

GET /api/v1/health

Liveness probe (app + database). Used by the platform health checker.