GET /volatility-index/:symbol

Risk metrics and volatility analysis.

Cost: $0.02 USDC

Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Token symbol
period	string	No (default: 7d)	Analysis period: 1d, 7d, 30d

Request

response = client.get("https://api.foursec.xyz/volatility-index/ETH")
data = response.json()

Response

{
  "symbol": "ETH",
  "period": "7d",
  "volatility_24h": 3.2,
  "volatility_7d": 5.8,
  "volatility_30d": 12.1,
  "risk_level": "medium",
  "risk_metrics": {
    "var_95_1d": 4.2,
    "var_99_1d": 6.8,
    "sharpe_ratio": 1.8,
    "max_drawdown_30d": 12.5,
    "beta_vs_btc": 0.85,
    "correlation_vs_btc": 0.92
  },
  "price_distribution": {
    "mean": 2450.00,
    "std_dev": 78.40,
    "skewness": -0.15,
    "kurtosis": 3.2
  },
  "sentiment": {
    "score": 0.72,
    "label": "bullish",
    "sources_analyzed": 150,
    "confidence": 0.85
  },
  "timestamp": "2026-07-04T15:30:00Z"
}

Response Fields

Field	Type	Description
symbol	string	Token symbol
volatility_24h	float	24h annualized volatility (%)
volatility_7d	float	7-day annualized volatility (%)
volatility_30d	float	30-day annualized volatility (%)
risk_level	string	low, medium, high, extreme

Risk Metrics

Field	Type	Description
var_95_1d	float	Value at Risk 95% confidence (1 day, %)
var_99_1d	float	Value at Risk 99% confidence (1 day, %)
sharpe_ratio	float	Risk-adjusted return (higher = better)
max_drawdown_30d	float	Max loss from peak in 30 days (%)
beta_vs_btc	float	Price sensitivity vs BTC
correlation_vs_btc	float	Price correlation vs BTC (-1 to 1)

Sentiment

Field	Type	Description
score	float	Sentiment score (0 = bearish, 1 = bullish)
label	string	bullish, neutral, or bearish
sources_analyzed	int	Number of data sources for sentiment
confidence	float	Confidence level (0-1)

Risk Level Interpretation

Level	Volatility	Recommendation
low	< 3%	Safe for large positions
medium	3-8%	Normal trading conditions
high	8-15%	Reduce position sizes
extreme	> 15%	Avoid or hedge aggressively