ABYSS Index API

Free public API. It returns OUR computed index and metrics (our own data), free to redistribute with attribution to ABYSS Index. No key, open CORS, CDN-cached. Great for sites, bots, dashboards and videos.

Base & assets

Base URL: https://abyssindex.com

Assets (?asset=): btc · eth · sol · xrp · doge · ada

Endpoints

GET /api/v1/index

Current ABYSS Score + components and market readings.

Parameters: ?asset=btc

Example response

{
  "index": "ABYSS-BTC",
  "asset": "btc",
  "score": 63,
  "band": "accumulation",
  "formulaVersion": "abyss-btc-1.0.0",
  "asOf": "2026-07-01T00:00:00.000Z",
  "market": { "priceUsd": 58365, "fearGreed": 41, "fearGreedClass": "Fear" },
  "components": [
    { "key": "sentiment_fng", "subScore": 59, "weight": 0.20, "contribution": 11.8 },
    { "key": "trend_ema200_w", "subScore": 72, "weight": 0.15, "contribution": 10.8 }
  ]
}

GET /api/v1/mvrv

On-chain MVRV, NUPL and realized price, computed from our own Bitcoin node. Returns status:pending while the node finishes syncing.

Parameters: ?asset=btc

Example response

{
  "index": "ABYSS-BTC",
  "asset": "btc",
  "date": "2026-07-01",
  "mvrv": 1.10,
  "mvrvZ": 0.18,
  "nupl": 0.09,
  "realizedPrice": 53164.61,
  "realizedCap": 1065983001495,
  "marketCap": 1173648233242,
  "supplyBtc": 20050613.64,
  "lthPct": 0.8033,
  "hodl": { "<1m": 0.0658, "6-12m": 0.1866, "5y+": 0.3323 },
  "mayer": 1.06,
  "puell": 1.04,
  "priceUsd": 58534.28,
  "height": 956269,
  "source": "self-hosted Bitcoin node"
}

GET /api/v1/altseason

Altseason index (0-100): strength of the alt basket vs BTC, with per-asset detail. No parameters.

GET /api/v1/history

Weekly ABYSS Score series since 2018 (reconstructed point-in-time, no look-ahead).

Parameters: ?asset=btc

Example response

{
  "index": "ABYSS-BTC",
  "asset": "btc",
  "formulaVersion": "abyss-btc-1.0.0",
  "count": 440,
  "points": [
    { "date": "2018-01-07", "score": 41, "bandKey": "neutral" },
    { "date": "2018-01-14", "score": 38, "bandKey": "late_cycle" }
  ]
}

GET /api/v1/history/csv

Same as /history but as a downloadable CSV.

Parameters: ?asset=btc

Caching & CORS

All responses carry Cache-Control (CDN-served) and Access-Control-Allow-Origin: *, so you can call them from the browser. The index refreshes every ~60s; history hourly; on-chain every ~10min.

License & attribution

The index and metrics are ABYSS's own data (our IP). Use and redistribute them for free, citing “ABYSS Index (abyssindex.com)” with a link. Don't re-expose third-party raw data; we only publish what we compute.

For educational purposes only. Not financial advice.