Earth Compute
For developers

JSON API

Free, read-only, CORS-open, no key required. Every response carries methodology_version and generated_at, and every compute figure is in the same unit as the site: peak dense BF16 FLOP/s. Rate-limited politely; if you need the whole series, pull /compute/history once and cache it.

Units

All *_flops fields are peak dense BF16 floating-point operations per second. total_h100e converts to H100-equivalents at 9.894×1014 FLOP/s each.

The headline is on the order of 1022, which is past the range where a 64-bit integer is exact, so it is stored and returned as a float64 — correct to about sixteen significant digits. Every response also carries total_flops_str, the same value as plain digits with no exponent, so you can parse it as a big integer without a float round-trip. It is named _str and not _exact deliberately: the last few digits are float artefacts, and the real uncertainty in these estimates is around ten percent, not 10-16.

One field is deliberately not in FLOP/s: the Bitcoin overlay is integer operations per second, which is why it is in /excluded and never in the headline.

GET /api/v1/compute/latest

The current headline plus the full per-constituent breakdown: value, share of total, update mode, freshness state, and whether it is summed.

curl https://earthcompute.org/api/v1/compute/latest
GET /api/v1/compute/history

The whole daily series from 2008, oldest first. Each point carries the headline, its H100-equivalent count, the delivered cross-check, and is_backfill — true for every point before the January 2026 anchor, which is reconstructed rather than captured live.

curl https://earthcompute.org/api/v1/compute/history
curl https://earthcompute.org/api/v1/compute/history?format=csv
GET /api/v1/constituents

The registry: every slice with its label, category, normalization note, growth rate, source citation, overlap treatment, and latest value.

curl https://earthcompute.org/api/v1/constituents
GET /api/v1/countries

All countries with their share of world compute, absolute FLOP/s, population and compute per person, ranked.

curl https://earthcompute.org/api/v1/countries
GET /api/v1/country/{iso}

One country by ISO-3 code (case-insensitive).

curl https://earthcompute.org/api/v1/country/usa
GET /api/v1/growth

Year-over-year change, headline and per constituent, sorted fastest first. This is the cadence that carries information: installed compute is an inventory that accretes about 0.1% a day, so the 1-day figure is noise, while the 1-year figure separates the AI accelerator lines (+141% to +257%) from everything else (+6% to +19%).

curl https://earthcompute.org/api/v1/growth
GET /api/v1/delivered

The utilization-weighted cross-check, its band, and the per-constituent duty factors behind it. Roughly an eighth to a fifth of the headline.

curl https://earthcompute.org/api/v1/delivered
GET /api/v1/excluded

Everything shown and never summed: Bitcoin's mining fleet, vendor marketing headroom, announced-but-unbuilt capacity, the TOP500 double-count, and the biological baseline.

curl https://earthcompute.org/api/v1/excluded
GET /api/v1/status

Freshness: the as-of date, when it was computed, and how many constituents were fetched live versus carried from last-known.

curl https://earthcompute.org/api/v1/status
GET /api/v1/methodology

The methodology version, the unit definition, the H100-equivalent conversion, and the pillars in short form.

curl https://earthcompute.org/api/v1/methodology
GET /api/v1/health

Liveness probe. App up plus a single database ping.

curl https://earthcompute.org/api/v1/health

Terms

Use it for anything, including commercially. Attribution to Earth Compute with a link is appreciated but not required. There is no uptime guarantee — this is a single small machine. If you build something interesting on it, that is the entire point.

These are estimates with stated assumptions, not measurements of a physical census. Read the methodology before quoting a number.