Skip to main content
skill CX Codex

kelly-criterion — Claude Code skill: optimal bet sizing

A skill that works out position size with the Kelly criterion: the formula, fractional variants, edge estimation and a correlation adjustment.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add agiprolabs/claude-trading-skills --skill kelly-criterion -a claude-code
Open on GitHub

What kelly-criterion does

The skill hands your agent a ready method for sizing a bet against your bankroll. Inside you get the formula f* = (p * b - q) / b, a quick-reference table by win rate and payoff ratio, a breakdown of fractional Kelly, and a classification of edge strength. Crypto-specific material covers simultaneous positions: uncorrelated bets are scaled so the fractions sum to no more than 1.0, while correlated ones (several memecoins that dump together) get trimmed through an effective number of independent bets.

Edge estimation runs off trade history — win rate and the ratio of average win to average loss. The skill ships Python code for that: a calculation over a list of trades and a wilson_lower function for the lower bound of the Wilson score interval, so a lucky sample does not inflate your win rate. It also states the data floor: 50 trades for any Kelly calculation, 100+ for half Kelly.

The catch sits in the method itself. Full Kelly is almost never the right call. Estimation error makes it overbet, and overbetting by 2x wipes out long-term growth entirely. The author recommends 0.25x–0.5x fractions, and 0.10x for a new strategy with fewer than 30 trades in the sample. When edge is zero or negative, the optimal bet is zero.

What it helps with

  • size a position from a known win rate and payoff ratio
  • estimate a strategy's edge from trade history
  • pick a fractional Kelly multiplier that fits the sample size
  • trim position sizes when bets are correlated
  • check whether a small sample inflated the win rate

Example prompts for the agent

  • size this position with Kelly for a 55% win rate and 2:1 payoff
  • estimate the edge of my strategy from the trades in trades.csv
  • I hold four memecoin positions — recalculate the fractions with a correlation adjustment

How to install kelly-criterion

1Skills CLI (Vercel)

npx skills add agiprolabs/claude-trading-skills --skill kelly-criterion -a claude-code

2Manually: put the files in place

~/.claude/skills/kelly-criterion/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/kelly-criterion/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about kelly-criterion

How do I install kelly-criterion in Claude?

Run npx skills add agiprolabs/claude-trading-skills --skill kelly-criterion -a claude-code. The skill lands in ~/.claude/skills/kelly-criterion/SKILL.md.

What does kelly-criterion do?

It calculates optimal bet size with the Kelly criterion, covers fractional variants, helps estimate a strategy's edge, and adjusts fractions when several positions are open at once.

How many trades do I need for the calculation?

The skill sets the floor at 50 trades for any Kelly calculation and 100+ for half Kelly. Aggressive fractions call for 200+ trades.

Source text

SKILL.md · MIT
---
name: kelly-criterion
description: Kelly criterion optimal sizing with fractional variants, edge estimation, and practical application for crypto trading
---

# Kelly Criterion — Optimal Bet Sizing

The Kelly criterion is the mathematically optimal bet size that maximizes long-term geometric growth of capital. Developed by John Kelly at Bell Labs in 1956, it answers a precise question: given a known edge, what fraction of your bankroll should you risk to maximize the compounding rate?

**Core insight**: Betting too small leaves growth on the table. Betting too large increases ruin risk and actually *reduces* long-term growth. Kelly finds the exact optimum between these extremes.

**Practical insight**: You should almost never use full Kelly. Estimation error in your edge means full Kelly will overbets in practice. Use fractional Kelly (0.25x to 0.5x) for real trading.

---

## The Kelly Formula

For a binary outcome (win or lose):

```
f* = (p * b - q) / b
```

Where:
- `f*` = optimal fraction of bankroll to bet
- `p` = probability of winning
- `q` = probability of losing (1 - p)
- `b` = payoff ratio (average win / average loss)

**Equivalent forms**:

```
f* = p - q / b
f* = p - (1 - p) / b
f* = (p * b - (1 - p)) / b
```

**Edge** = `p * b - q` = expected value per unit risked. Kelly only makes sense when edge > 0. If edge is zero or negative, the optimal bet is zero — do not trade.

### Quick Reference

| Win Rate | Payoff 1:1 | Payoff 1.5:1 | Payoff 2:1 | Payoff 3:1 |
|----------|-----------|-------------|-----------|-----------|
| 40%      | -20%      | -6.7%       | 10%       | 20%       |
| 45%      | -10%      | 3.3%        | 15%       | 25%       |
| 50%      | 0%        | 16.7%       | 25%       | 33.3%     |
| 55%      | 10%       | 18.3%       | 27.5%     | 35%       |
| 60%      | 20%       | 26.7%       | 35%       | 40%       |

*Values are full Kelly fraction. In practice, use 0.25x to 0.5x of these numbers.*

---

## Why Use Fractional Kelly

Full Kelly assumes you know `p` and `b` exactly. You never do. Here is why fractional Kelly is essential:

### 1. Estimation Error

Your win rate estimate from 100 trades has a standard error of roughly ±5%. If your true win rate is 55% but you estimate 60%, full Kelly will overbets by ~50%, which *reduces* long-term growth below what half Kelly would achieve.

### 2. Variance and Drawdowns

Full Kelly has extremely high variance. Expected maximum drawdown for full Kelly is roughly 50-80% of account. This is psychologically devastating and practically dangerous (margin calls, inability to continue trading).

| Kelly Fraction | Relative Growth Rate | Approximate Max Drawdown |
|---------------|---------------------|-------------------------|
| 1.0x (full)   | 100%                | 50-80%                  |
| 0.5x (half)   | ~75%                | 25-40%                  |
| 0.25x (quarter)| ~50%               | 12-20%                  |
| 0.1x (tenth)  | ~25%                | 5-10%                   |

### 3. Asymmetry of Over vs. Under Betting

Overbetting by 2x (betting at 2*f*) produces **zero** long-term growth — the same as not trading at all. Underbetting by 2x (betting at 0.5*f*) still captures ~75% of the optimal growth rate. The penalty for overbetting is catastrophically worse than for underbetting.

### Recommended Fractions

| Fraction | When to Use |
|----------|------------|
| 0.10x Kelly | Very uncertain edge, new strategy, < 30 trades in sample |
| 0.25x Kelly | Moderate confidence, 30-100 trades, reasonable Sharpe |
| 0.50x Kelly | High confidence, 100+ trades, consistent performance |
| 1.00x Kelly | Never recommended in practice |

---

## Estimating Your Edge

Kelly requires two inputs: win rate (`p`) and payoff ratio (`b`). Both must be estimated from data.

### Minimum Data Requirements

- **50 trades minimum** for any Kelly calculation. Below this, estimation error dominates.
- **100+ trades preferred** for half Kelly sizing.
- **200+ trades** before considering aggressive fractions.

### Calculation from Trade History

```python
wins = [t for t in trades if t > 0]
losses = [t for t in trades if t < 0]

win_rate = len(wins) / len(trades)               # p
payoff_ratio = mean(wins) / abs(mean(losses))     # b
edge = win_rate * payoff_ratio - (1 - win_rate)   # should be > 0

kelly_full = (win_rate * payoff_ratio - (1 - win_rate)) / payoff_ratio
```

### Conservative Estimation

Use the **lower bound of a Wilson confidence interval** for win rate rather than the point estimate:

```python
import math

def wilson_lower(wins: int, total: int, z: float = 1.96) -> float:
    """Lower bound of Wilson score interval (95% confidence)."""
    p = wins / total
    denominator = 1 + z**2 / total
    centre = p + z**2 / (2 * total)
    spread = z * math.sqrt((p * (1 - p) + z**2 / (4 * total)) / total)
    return (centre - spread) / denominator
```

Using the lower bound of the confidence interval for win rate automatically builds in conservatism, reducing the risk of overbetting due to sampling luck.

### Edge Strength Classification

| Edge Value | Classification | Notes |
|-----------|---------------|-------|
| < 0       | Negative edge | Do not trade this strategy |
| 0 - 0.02  | No meaningful edge | Transaction costs likely exceed edge |
| 0.02 - 0.10 | Marginal edge | Conservative fractions only |
| 0.10 - 0.20 | Good edge | Standard fractions appropriate |
| > 0.20    | Excellent edge | Rare; verify not overfitting or temporary |

---

## Multi-Bet Kelly (Simultaneous Positions)

When holding multiple positions simultaneously:

### Independent Bets

If bets are uncorrelated, each can be sized at its individual Kelly fraction. However, the **sum of all Kelly fractions** should not exceed 1.0 (total portfolio). If it does, scale each proportionally:

```python
kelly_fractions = [0.15, 0.10, 0.12, 0.08]  # individual Kelly fractions
total = sum(kelly_fractions)  # 0.45
if total > 1.0:
    scale = 1.0 / total
    kelly_fractions = [f * scale for f in kelly_fractions]
```

### Correlated Bets

Correlated positions (e.g., multiple SOL memecoins) are effectively one larger bet. Reduce each position proportionally to the correlation:

```python
# Simple correlation adjustment
def adjust_for_correlation(kelly_fractions: list, avg_correlation: float) -> list:
    """Reduce Kelly fractions based on average inter-position correlation."""
    n = len(kelly_fractions)
    # Effective number of independent bets
    n_eff = n / (1 + (n - 1) * avg_correlation)
    scale = n_eff / n
    return [f * scale for f in kelly_fractions]
```

In crypto, meme token positions often have correlations of 0.5-0.8 with each other (they all dump together in risk-off). Treat them as partially one bet.

### Portfolio Kelly Cap

Regardless of individual calculations, enforce a hard cap: **total Kelly allocation should never exceed 1.0** (100% of portfolio). A practical maximum is 0.6-0.8 to leave cash buffer for drawdowns and new opportunities.

---

## PumpFun / Meme Token Kelly

Meme token trading presents specific challenges for Kelly:

1. **Edge is hard to estimate**: Win rates and payoff ratios shift rapidly with market regime.
2. **Fat tails dominate**: A few large winners and many small losers. Standard Kelly assumes thin tails.
3. **Correlation spikes in drawdowns**: All meme tokens can dump simultaneously.

### Practical Adjustments

- Use **0.1x to 0.25x Kelly** maximum for meme tokens.
- Cap absolute position size at **2-5% of portfolio** regardless of Kelly output.
- Recalculate edge weekly — stale estimates are dangerous.
- If Kelly suggests > 30%, your edge estimate is almost certainly wrong. Use 5% maximum.

```python
def meme_kelly(win_rate: float, payoff_ratio: float, account: float) -> float:
    """Conservative Kelly for high-uncertainty meme token trades."""
    kelly_full = (win_rate * payoff_ratio - (1 - win_rate)) / payoff_ratio
    kelly_conservative = kelly_full * 0.15  # 0.15x fractional
    max_fraction = 0.05                     # hard cap at 5%
    return min(max(kelly_conservative, 0), max_fraction) * account
```

---

## When Kelly Does Not Work

Kelly optimality relies on assumptions that are often violated:

| Assumption | Reality | Impact |
|-----------|---------|--------|
| Known edge (p, b) | Estimated from noisy data | Overbetting risk |
| Independent bets | Correlated positions | Ruin risk increases |
| Binary outcomes | Continuous P&L distribution | Formula approximation |
| Stationary edge | Edge changes over time | Stale sizing |
| No transaction costs | Slippage, fees, MEV | Effective edge lower |
| Unlimited divisibility | Minimum position sizes | Rounding needed |

### Mitigations

1. **Use fractional Kelly** (addresses estimation error)
2. **Adjust for correlation** (addresses dependence)
3. **Use continuous Kelly** for non-binary returns (see `references/kelly_derivation.md`)
4. **Recalculate regularly** (addresses non-stationarity)
5. **Subtract estimated costs** from edge before calculating Kelly

---

## Continuous Kelly (For Portfolio Returns)

When returns are continuous rather than binary win/lose:

```
f* = (μ - r) / σ²
```

Where:
- `μ` = expected return of the strategy
- `r` = risk-free rate (often 0 for crypto)
- `σ²` = variance of returns

This is equivalent to `Sharpe² / (2 * σ)` when the Sharpe ratio is computed as `(μ - r) / σ`.

Use this form when you have a return stream rather than discrete win/loss trades. See `references/kelly_derivation.md` for the full derivation.

---

## Integration with Other Skills

- **`position-sizing`**: Kelly provides the optimal fraction; position-sizing translates that into units. Use Kelly as one input, then apply liquidity and volatility constraints from position-sizing.
- **`risk-management`**: Kelly sizing must respect portfolio-level risk limits. If Kelly suggests 10% per trade but your risk policy caps at 5%, the cap wins.
- **`strategy-framework`**: Document your Kelly parameters (fraction used, sample size, recalculation frequency) as part of strategy specification.
- **`regime-detection`**: Recalculate Kelly when regime changes. Edge in a trending market differs from edge in a ranging market.

---

## Files

### References
- `references/kelly_derivation.md` — Full mathematical derivation of Kelly criterion, fractional Kelly growth rates, continuous Kelly, and multi-outcome Kelly
- `references/practical_kelly.md` — Edge estimation from trading data, confidence intervals, worked examples, common pitfalls, and danger zones

### Scripts
- `scripts/kelly_calculator.py` — Kelly calculator from win rate, payoff ratio, and account size. Prints fractional Kelly recommendations and sensitivity analysis. Dependencies: none.
- `scripts/kelly_from_trades.py` — Estimate Kelly from a list of trade P&L values. Computes confidence intervals, rolling stability analysis, and recommended fraction. Dependencies: numpy.

© agiprolabs · MIT · agiprolabs/claude-trading-skills

Similar skills

Everything for Finance and business →

From the same set52

risk-management A skill that sets portfolio risk rules for crypto trading: drawdown limits, daily and weekly loss stops, concentration caps and automated circuit breakers. CX Codex +1 631installs pandas-ta Equips coding agents with patterns for 130+ technical analysis indicators using pandas-ta on crypto market data. CX Codex +1 586installs position-sizing Calculates trade position sizes using five risk management models. Useful for setting up systematic trading rules and managing drawdown risks. CX Codex +1 572installs regime-detection A Claude skill that classifies the current market as trending or ranging and tells you how volatile it is. Useful before you pick a strategy. CX Codex +1 574installs trade-journal Logs trading activity with entry rationale, attributes returns to strategy tags, and detects revenge trading or FOMO. Useful for systematic performance reviews. CX Codex +1 515installs feature-engineering Builds features from market data for ML trading models: price, volume, microstructure, on-chain. Useful when a model trained on raw candles keeps overfitting. CX Codex +1 517installs signal-classification A skill that builds ML trading signal classifiers on XGBoost and LightGBM, with walk-forward validation, SHAP importance and threshold tuning. CX Codex +1 516installs market-microstructure Reads the Solana DEX trade tape: buys versus sells, buyer and seller pressure, trade size distribution. Useful when you want to gauge flow in a token before entering. CX Codex +1 515installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor