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-07-28",
  "gramsPerBtc": 489.559801869861,
  "btcUsd": 63630.89,
  "goldUsdPerOz": 4042.699951171875
}

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

{
  "snapshots": [
    {
      "date": "2026-07-24",
      "gramsPerBtc": 490.022493796401,
      "btcUsd": 64083.32,
      "goldUsdPerOz": 4067.60009765625
    },
    {
      "date": "2026-07-27",
      "gramsPerBtc": 486.2240038053749,
      "btcUsd": 63694.43,
      "goldUsdPerOz": 4074.5
    },
    {
      "date": "2026-07-28",
      "gramsPerBtc": 489.559801869861,
      "btcUsd": 63630.89,
      "goldUsdPerOz": 4042.699951171875
    }
  ]
}

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