Crypto realized volatility & risk API

Fetch a coin's daily price history (keyless CoinGecko) and compute its risk profile: annualized realized volatility, maximum drawdown, a Sharpe-ish ratio, total return and best/worst day. The value-add is the risk math — an agent gets a price array, not the volatility and drawdown that describe the asset's risk. Answers 'how volatile is BTC', 'max drawdown of ETH', 'annualized volatility of this coin', 'is this token risky'.

Price$0.01per request

MethodPOST

Route/v1/finance/crypto-volatility

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

financecryptovolatilityriskdrawdownsharpestdevrealized-vol

API URLhttps://x402.hexl.dev/v1/finance/crypto-volatility

Integration docs

Example request

{
  "id": "bitcoin",
  "days": 90
}

Example response

{
  "id": "bitcoin",
  "days": 90,
  "observations": 89,
  "startPrice": 58234.1,
  "endPrice": 67120.4,
  "totalReturnPct": 15.26,
  "meanDailyReturnPct": 0.17,
  "dailyVolatilityPct": 2.31,
  "annualizedVolatilityPct": 44.13,
  "sharpeRatio": 1.42,
  "maxDrawdownPct": -12.84,
  "bestDayPct": 6.71,
  "worstDayPct": -8.02
}

Input schema

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "examples": [
        "bitcoin"
      ]
    },
    "days": {
      "type": "number",
      "default": 30,
      "examples": [
        90
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}