GET/api/v1/market-indicators/{indicator}

Fetch market-wide indicator data including crypto risk metrics, altcoin season, market breadth, and more.

Fetches time-series data for market-wide indicators. These are computed metrics spanning the entire crypto market, including per-asset risk scores, altcoin season indices, market breadth, and recession risk signals.

#Authentication

Requires an API key with an active Pro subscription and market-indicators permission.

x-api-key: YOUR_API_KEY

#URL Parameters

ParameterTypeDescription
indicatorstringThe market indicator ID (see categories below)

Use list as the indicator to get all available indicators:

curl -H "x-api-key: YOUR_API_KEY" \
  https://chartinspect.com/api/v1/market-indicators/list

#Query Parameters

ParameterTypeDefaultDescription
daysnumberallReturn only the last N days of data
startDatestringnoneStart of date range (YYYY-MM-DD)
endDatestringnoneEnd of date range (YYYY-MM-DD)
limitnumbernoneMaximum data points (max 10,000)

#Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://chartinspect.com/api/v1/market-indicators/crypto-risk-btc?days=30"

#Response

json
{
  "success": true,
  "indicator": "crypto-risk-btc",
  "count": 30,
  "data": [
    {
      "timestamp": 1775001600,
      "close": 68096.26,
      "riskLevel": 0.2548,
      "closeRiskLevel": 0.1382,
      "lowRiskLevel": 0.3493,
      "highRiskLevel": 0.1280
    }
  ],
  "metadata": {
    "processingTime": 8,
    "timestamp": "2026-04-01T16:00:00.000Z",
    "dataRange": { "start": "2026-03-01", "end": "2026-03-31" },
    "apiVersion": "v1"
  }
}

#Available Indicators

#Crypto Risk Metrics (Per-Asset)

Risk scores computed for 70+ individual cryptocurrencies. Format: crypto-risk-{symbol}

ID PatternExampleDescription
crypto-risk-btcBitcoin riskRisk score for Bitcoin (0-1 scale)
crypto-risk-ethEthereum riskRisk score for Ethereum
crypto-risk-solSolana riskRisk score for Solana
crypto-risk-adaCardano riskRisk score for Cardano
crypto-risk-dogeDogecoin riskRisk score for Dogecoin
crypto-risk-xrpXRP riskRisk score for XRP
crypto-risk-bnbBNB riskRisk score for BNB
crypto-risk-linkChainlink riskRisk score for Chainlink
crypto-risk-dotPolkadot riskRisk score for Polkadot
crypto-risk-avaxAvalanche riskRisk score for Avalanche

And 60+ more assets. Use the list endpoint to see all available risk metrics.

#Altcoin Season Index

Measures whether altcoins are outperforming Bitcoin across different timeframes and market cap tiers.

IDDescription
altcoin-season-index-30d-top-1030-day altcoin season index (top 10 by market cap)
altcoin-season-index-30d-top-5030-day altcoin season index (top 50)
altcoin-season-index-30d-top-10030-day altcoin season index (top 100)
altcoin-season-index-90d-top-1090-day altcoin season index (top 10)
altcoin-season-index-90d-top-5090-day altcoin season index (top 50)
altcoin-season-index-90d-top-10090-day altcoin season index (top 100)
altcoin-season-index-180d-top-50180-day altcoin season index (top 50)
altcoin-season-index-365d-top-50365-day altcoin season index (top 50)

Available in all combinations of timeframes (30d, 90d, 180d, 365d) and tiers (top-10, top-20, top-50, top-100, top-150, top-250).

#Crypto Market Breadth

Percentage of cryptocurrencies trading above key moving averages.

IDDescription
crypto-market-breadth-20d-sma-top-50% above 20-day SMA (top 50 cryptos)
crypto-market-breadth-50d-sma-top-50% above 50-day SMA (top 50)
crypto-market-breadth-100d-sma-top-50% above 100-day SMA (top 50)
crypto-market-breadth-200d-sma-top-50% above 200-day SMA (top 50)
crypto-market-breadth-21w-ema-top-50% above 21-week EMA (top 50)
crypto-market-breadth-kama-top-50% above KAMA (top 50)

Available for all tier sizes (top-10, top-20, top-50, top-100, top-150, top-250) and moving average types (20d SMA, 50d SMA, 100d SMA, 200d SMA, 20w SMA, 21w EMA, KAMA).

#Market Risk Indicators

IDDescription
market-risk-indicator-top10-noneComposite risk for top 10 cryptocurrencies
market-risk-indicator-top25-noneComposite risk for top 25
market-risk-indicator-top50-noneComposite risk for top 50

#Other Indicators

IDDescription
advanced-decline-indexAdvance/decline breadth index
aggregate-market-mvrv-divergenceCross-market MVRV divergence signal
combined-vwap-mvrvCombined VWAP-MVRV divergence metric
eth-btc-ratioETH/BTC price ratio
recession-risk-crpiRecession risk (CRPI model)
recession-risk-emoRecession risk (EMO model)

#Notes

  • Market indicators are updated hourly by the market worker.
  • Crypto risk metrics cover 70+ assets and are recomputed each cycle.
  • Altcoin season values range from 0-100 (0 = Bitcoin season, 100 = altcoin season).
  • Use the list endpoint to discover all 150+ available indicator IDs.
Was this page helpful?