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/latestThe latest Expected Volatility reading for an asset: expected, realised, the gap and the percentile.
GET /api/barometer/v1/volatility/historyHourly or daily readings for an asset, between two dates.
GET /api/barometer/v1/stablecoins/latestThe latest supply for each token and chain, with net flows over 24 hours and 7 days, and the totals.
GET /api/barometer/v1/stablecoins/historyHourly or daily supply and flows, between two dates.
GET /api/barometer/v1/versionsEvery method version, with its date and what changed.
Examples
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"
}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.