---
title: "Get Market Health"
method: GET
path: "/api/v1/market-health"
tags: ["Market Health"]
---

# Get Market Health

`GET /api/v1/market-health`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/market-health`
- Auth: API key in header `X-API-Key`

Full dual-score market health result with all 11 components.

**`indicators` contract**

Top-level `indicators` is a flat denormalization of the most-filtered values
from `components.<x>.details`. Keys are **omitted entirely** when the source
value is unavailable (never null) so consumers can safely use
`dict.get(key, default)` for fallbacks. Committed key set:

- `long_short_ratio` (float) — BTC long/short ratio (Binance perps)
- `funding_rate` (float, %) — avg funding rate (aliased from `avg_funding_rate`)
- `buy_ratio` (float, 0–1) — weighted taker-buy ratio across top spot pairs
- `fear_greed_value` (int, 0–100) — averaged Fear & Greed index
- `breadth_pct` (float, %) — share of top-30 coins above their 200D MA
- `pct_from_200ma` (float, %) — BTC distance from 200D MA
- `cross_status` (str) — Golden | Death | Neutral
- `stablecoin_change_7d` (float) — 7-day stablecoin market-cap change

Health is computed cross-exchange (CoinGlass aggregate + Binance) and is not
scoped by any per-exchange filter. The `long_short_ratio` is BTC-on-Binance,
used as a market-wide sentiment signal.

## Response `200`

Successful Response

- MarketHealthResponse: Full market health score response.
  - `total_score` integer, required
  - `long_term_score` integer, required
  - `short_term_score` integer, required
  - `state` string, required
  - `sentiment` string, required
  - `long_term_sentiment` string, required
  - `short_term_sentiment` string, required
  - `components` ComponentScoreSchema[], required
    - `name` string, required
    - `score` integer, required
    - `weight` number, required
    - `description` string, required
    - `details` object
  - `long_term_components` ComponentScoreSchema[], required
    - `name` string, required
    - `score` integer, required
    - `weight` number, required
    - `description` string, required
    - `details` object
  - `short_term_components` ComponentScoreSchema[], required
    - `name` string, required
    - `score` integer, required
    - `weight` number, required
    - `description` string, required
    - `details` object
  - `details` object
  - `indicators` object, nullable
  - `timestamp` string, date-time, 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)