본문으로 건너뛰기
cccskills
무료GitHub에 공개

volatility-modeling

Volatility estimation, forecasting, and regime classification using GARCH, EWMA, realized volatility, and volatility cones

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(5)

  • SKILL.md8.2 KB
  • references/estimators.md5.7 KB
  • references/volatility_cones.md6.1 KB
  • scripts/estimate_volatility.py17.1 KB
  • scripts/vol_forecast.py18.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Volatility Modeling

Volatility — the magnitude of price fluctuations — is arguably the single most important quantity in trading. It drives position sizing, stop placement, option pricing, and regime detection. This skill covers estimation, forecasting, and practical application of volatility in crypto markets.

Why Volatility Matters

Use CaseHow Volatility Is Used
Position sizingScale position inversely with vol so each trade risks a consistent dollar amount
Stop placementATR-based stops widen in high-vol regimes, tighten in low-vol
Strategy selectionMean-reversion works in low vol; momentum works in high vol
Risk budgetingVol-target portfolios maintain constant portfolio-level risk
Regime detectionVol regime shifts signal changing market dynamics
Option pricingImplied vs realized vol gap creates trading opportunities

Types of Volatility

Historical (Realized) Volatility

Computed from observed past returns. The most common and directly measurable form. Multiple estimators exist with different statistical efficiency.

Implied Volatility

Derived from option prices via Black-Scholes or similar models. Limited in crypto DeFi where liquid options markets are sparse, but available on Deribit for BTC/ETH.

Forecast Volatility

Predicted future volatility from models like EWMA or GARCH. Used for forward-looking position sizing and risk budgets.


Estimation Methods

1. Close-to-Close (Standard Deviation of Log Returns)

The simplest estimator. Compute the standard deviation of log returns and annualize.

import numpy as np

log_returns = np.log(closes[1:] / closes[:-1])
vol_daily = np.std(log_returns, ddof=1)
vol_annual = vol_daily * np.sqrt(365)  # crypto trades 365 days
  • Pros: Simple, widely understood.
  • Cons: Uses only close prices — ignores intraday range.

2. Parkinson (High-Low Range)

Uses the daily high-low range, which is ~5x more statistically efficient than close-to-close.

hl_ratio = np.log(highs / lows)
vol_parkinson = np.sqrt(np.mean(hl_ratio**2) / (4 * np.log(2))) * np.sqrt(365)
  • Pros: More efficient, captures intraday moves.
  • Cons: Downward bias with discrete sampling; ignores close-to-close jumps.

3. Garman-Klass (OHLC)

The most efficient single-day OHLC estimator.

hl = np.log(highs / lows)
co = np.log(closes / opens)
gk = np.mean(0.5 * hl**2 - (2 * np.log(2) - 1) * co**2)
vol_gk = np.sqrt(gk) * np.sqrt(365)
  • Pros: Best efficiency among OHLC estimators.
  • Cons: Assumes no drift; sensitive to opening gaps.

4. Yang-Zhang

Combines overnight (close-to-open) and open-to-close components. Handles gaps properly. Less relevant for 24/7 crypto but useful for tokens with sporadic trading.

5. EWMA (Exponentially Weighted Moving Average)

RiskMetrics approach — no parameters to estimate beyond λ.

lam = 0.94  # RiskMetrics default for daily
ewma_var = np.zeros(len(returns))
ewma_var[0] = returns[0] ** 2
for t in range(1, len(returns)):
    ewma_var[t] = lam * ewma_var[t - 1] + (1 - lam) * returns[t - 1] ** 2
vol_ewma = np.sqrt(ewma_var) * np.sqrt(365)
  • λ = 0.94 for daily data (RiskMetrics).
  • λ = 0.97 for weekly data.
  • Higher λ → smoother, slower reaction to new information.

6. GARCH(1,1)

The workhorse autoregressive volatility model. Captures volatility clustering.

σ²_t = ω + α · r²_{t-1} + β · σ²_{t-1}
  • ω: long-run variance weight.
  • α: reaction to recent shock (typically 0.05–0.15 for crypto).
  • β: persistence (typically 0.80–0.90 for crypto).
  • α + β < 1: stationarity constraint.
  • Long-run variance: ω / (1 − α − β).

Estimated via maximum likelihood. See references/estimators.md for details.


Volatility Cones

Volatility cones show the percentile distribution of realized volatility at different lookback windows, revealing whether current vol is historically high or low.

Construction

  1. Get 1+ years of daily data.
  2. For each lookback window (5, 10, 20, 60, 120 days):
    • Compute rolling realized volatility.
    • Extract percentiles: 5th, 25th, 50th, 75th, 95th.
  3. Plot percentiles vs window length — the "cone" shape.
  4. Overlay current realized vol at each window.

Interpretation

  • Current vol > 75th percentile: historically elevated — expect mean reversion.
  • Current vol < 25th percentile: historically compressed — expect expansion.
  • Cone narrowing at longer windows: vol mean-reverts over longer horizons.

See references/volatility_cones.md for full methodology and worked examples.


Crypto Volatility Characteristics

Crypto vol differs from traditional assets in important ways:

CharacteristicDetail
Level50–150% annualized is typical; TradFi equities are 15–25%
ClusteringStrong — high-vol days cluster together
Weekday patternsWeekend vol often lower but weekend gaps can be large
Volume correlationVol and volume are positively correlated
Regime dependenceBull market vol ≠ bear market vol; ranges are different
Mean reversionVol mean-reverts more reliably than price
Tail riskFat tails — more extreme moves than normal distribution predicts

Regime Classification by Volatility

RegimeAnnualized Vol RangeCharacteristics
Low vol< 40%Range-bound, mean reversion works
Normal vol40–80%Trending possible, balanced strategies
High vol80–120%Strong trends or sharp reversals
Crisis vol> 120%Liquidation cascades, reduced position size

Volatility Forecasting

EWMA Forecast

Simple and effective. The current EWMA variance estimate is the 1-step forecast. Multi-step forecasts are flat (same as 1-step).

GARCH Forecast

GARCH produces a term structure of variance forecasts:

σ²_{t+h} = V_L + (α + β)^h · (σ²_t − V_L)

Where V_L = ω / (1 − α − β) is the long-run variance.

  • Short-horizon forecasts reflect current conditions.
  • Long-horizon forecasts converge to long-run variance.
  • The speed of convergence depends on α + β (persistence).

See scripts/vol_forecast.py for a working implementation.


Practical Applications

Position Sizing with Volatility

# Vol-target position sizing
target_vol = 0.02  # 2% daily portfolio vol target
current_vol = 0.05  # 5% daily asset vol (annualized ~95%)
weight = target_vol / current_vol  # = 0.40 → 40% allocation

See the position-sizing skill for complete integration.

ATR-Based Stop Placement

atr_14 = talib.ATR(highs, lows, closes, timeperiod=14)
stop_distance = 2.0 * atr_14[-1]  # 2x ATR stop
stop_price = entry_price - stop_distance  # for longs

Vol-Regime Strategy Selection

vol_percentile = current_vol_percentile(token, window=30)
if vol_percentile < 25:
    strategy = "mean_reversion"
elif vol_percentile > 75:
    strategy = "momentum_breakout"
else:
    strategy = "balanced"

Files

References

FileDescription
references/estimators.mdFull derivations and details for all volatility estimators
references/volatility_cones.mdCone construction methodology and interpretation guide

Scripts

FileDescription
scripts/estimate_volatility.pyMulti-estimator volatility computation with cone analysis
scripts/vol_forecast.pyEWMA and GARCH forecasting with term structure output

Related Skills

  • regime-detection — Classify market regimes using volatility as a key input.
  • position-sizing — Scale positions inversely with volatility.
  • risk-management — Portfolio-level vol targeting and risk budgets.
  • pandas-ta — ATR and Bollinger Bands are volatility-based indicators.
  • custom-indicators — Build crypto-specific volatility indicators.

Dependencies

uv pip install pandas numpy scipy

Optional for live data:

uv pip install httpx

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers, and custom indicators

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

Broad crypto market data from CoinGecko covering 13,000+ tokens. Global market stats, historical price data going back years, exchange volumes, trending tokens, and category filters. Best for macro analysis and long-term historical data.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability analysis

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail dependence, and regime-dependent correlation

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

agiprolabs/claude-trading-skills4332026년 9월 3일 업데이트

agiprolabs의 스킬 모두 보기

이 스킬의 문제 신고