Skip to content
BAROMETER

barometer@atheron:/docs$

// Docs

One API, both feeds

REST and JSON.

Read the latest reading or its history with one call. The full reference lives in the developer portal, beside your keys.

Keys

Make keys in the Atheron developer portal. Send a key as a Bearer token.

  • Test keys start with ath_test_, return the same shapes and never charge you
  • Live keys start with ath_live_ and need the identity check first
  • A key needs the barometer right to read either feed
  • Keys are shown once and stored only as a hash

Freshness and history

A new reading is published every minute. History is kept from the first day the feed publishes, with a twelve-month volatility history rebuilt by the same method.

In the full reference

  • Quick start
  • Fields of each reading
  • Assets and chains
  • History and intervals
  • Method versions
  • Errors and limits
  • Usage

Endpoints

Every answer is JSON, and every reading names the method version that made it.

  • GET /api/barometer/v1/volatility/latest

    The latest Expected Volatility reading for an asset: expected, realised, the gap and the percentile.

  • GET /api/barometer/v1/volatility/history

    Hourly or daily readings for an asset, between two dates.

  • GET /api/barometer/v1/stablecoins/latest

    The latest supply for each token and chain, with net flows over 24 hours and 7 days, and the totals.

  • GET /api/barometer/v1/stablecoins/history

    Hourly or daily supply and flows, between two dates.

  • GET /api/barometer/v1/versions

    Every method version, with its date and what changed.

Examples

The latest volatility
curl "https://developers.aton-network.org/api/barometer/v1/volatility/latest?asset=BTC" \
  -H "Authorization: Bearer $ATHERON_KEY"

{
  "asset": "BTC",
  "expected_30d": 52.4,
  "realised_30d": 47.9,
  "gap": 4.5,
  "percentile_365d": 61,
  "method": { "name": "har-rv", "version": "1.0.0" },
  "as_of": "2026-10-26T03:00:00Z"
}
Daily stablecoin history
curl "https://developers.aton-network.org/api/barometer/v1/stablecoins/history?interval=day&from=2026-10-01" \
  -H "Authorization: Bearer $ATHERON_KEY"

{ "interval": "day", "points": [ { "day": "2026-10-01", "supply": 168.2e9, "net_24h": 3.1e8 } ] }

A question the docs do not answer? Talk to our team.

Docs | Atheron Barometer