---
title: "Get Onchain Health Score"
method: GET
path: "/api/v1/on-chain/score"
tags: ["On-Chain Intelligence"]
---

# Get Onchain Health Score

`GET /api/v1/on-chain/score`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/on-chain/score`
- Auth: API key in header `X-API-Key`

Composite 0-100 on-chain health score with per-component breakdown.

Synthesizes Hash Ribbon, MVRV, stablecoin dry-powder, whale accumulation,
exchange flow direction, and miner net flow into a single directional read.

Sentiment bands:
- **bullish** (≥70): broad on-chain confluence of accumulation signals
- **leaning_bullish** (55-69): tilted positive but mixed
- **neutral** (45-54)
- **leaning_bearish** (30-44)
- **bearish** (<30): broad distribution + miner stress + flow into CEXs

Kept separate from `/market-health` for v1. Components with no data yet are
EXCLUDED and the remaining weights renormalised, so a partially-warm deploy
reports the confluence it can actually see instead of being diluted toward a
confident-looking 50. When no component has data, `sentiment` is `unknown`.

`whale_accumulation` is currently always unavailable (whale tracking is
disabled, see `/on-chain/whales`): it reports `reason: "no_data"`, its
`score` of 50 is a placeholder and it carries weight 0, so it does not move
the composite. `exchange_flow` scores the USDT/USDC/DAI 24h net only; before
2026-10-08 it also summed other tokens in their native units, so its
`reason` magnitudes from then are not dollars.

## Response `200`

Successful Response

- OnChainHealthResponse
  - `as_of` integer, required
  - `score` number, required
  - `sentiment` string, required: bullish | leaning_bullish | neutral | leaning_bearish | bearish
  - `components` HealthComponent[], required
    - `name` string, required
    - `score` number, required
    - `weight` number, required
    - `reason` string, required
    - `raw` object, nullable
  - `weights_version` string, required

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)