ValueAtlas API

Public JSON endpoints for the BTC/gold dataset. Responses include permissive CORS and are designed so paid tiers can add broader history and extra assets later.

Free Endpoints

Method	Path	Notes
GET	`/api/v1/today`	Returns `{ date, gramsPerBtc, btcUsd, goldUsdPerOz }`.
GET	`/api/v1/history?limit=30`	Returns the last N days of data, clamped to 30 on the free tier.
OPTIONS	`/api/v1/*`	CORS preflight support for browser clients.

Compatibility Endpoints

Older snapshots and metric endpoints remain available for backwards compatibility while the public API migrates to /api/v1.

/api/health
/api/snapshots/latest
/api/snapshots/history
/api/metrics/latest
/api/metrics/history

Example: /api/v1/today

{
  "date": "2026-05-29",
  "gramsPerBtc": 503.80313029186624,
  "btcUsd": 73673.32,
  "goldUsdPerOz": 4548.39990234375
}

Example: /api/v1/history?limit=3

{
  "snapshots": [
    {
      "date": "2026-05-27",
      "gramsPerBtc": 519.7272813783025,
      "btcUsd": 74315.98,
      "goldUsdPerOz": 4447.5
    },
    {
      "date": "2026-05-28",
      "gramsPerBtc": 508.1897204489153,
      "btcUsd": 73512.56,
      "goldUsdPerOz": 4499.2998046875
    },
    {
      "date": "2026-05-29",
      "gramsPerBtc": 503.80313029186624,
      "btcUsd": 73673.32,
      "goldUsdPerOz": 4548.39990234375
    }
  ]
}

Future Tiers

Paid tiers can extend the same shape with longer history windows and additional assets such as silver, S&P 500, or oil. The current response structure keeps that door open without forcing a breaking change later.

The free tier is capped at 100 requests per UTC day per IP, with an extra Cloudflare burst limiter in front of it.

CORS header: Access-Control-Allow-Origin: *

Open comparisons | Open interactive app