Kelly Criterion logo

Kelly Criterion

Community
agiprolabs
kelly-criterion

Kelly criterion optimal sizing with fractional variants, edge estimation, and practical application for crypto trading

Overview

Publisheragiprolabs
Repositoryclaude-trading-skills
Skill namekelly-criterion
Stars
434
Forks
85
Bundled files
4
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 4 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by agiprolabs on GitHub. Read the source before you install it.

Installation

Install the Kelly Criterion AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/agiprolabs/claude-trading-skills/tree/main/skills/kelly-criterion
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/agiprolabs/claude-trading-skills.git /tmp/claude-trading-skills
mkdir -p .claude/skills
cp -r /tmp/claude-trading-skills/skills/kelly-criterion .claude/skills/kelly-criterion
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Kelly Criterion in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Kelly Criterion on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Kelly Criterion is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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 RatePayoff 1:1Payoff 1.5:1Payoff 2:1Payoff 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 FractionRelative Growth RateApproximate 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 2f) produces zero long-term growth — the same as not trading at all. Underbetting by 2x (betting at 0.5f) still captures ~75% of the optimal growth rate. The penalty for overbetting is catastrophically worse than for underbetting.

Recommended Fractions

FractionWhen to Use
0.10x KellyVery uncertain edge, new strategy, < 30 trades in sample
0.25x KellyModerate confidence, 30-100 trades, reasonable Sharpe
0.50x KellyHigh confidence, 100+ trades, consistent performance
1.00x KellyNever 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 ValueClassificationNotes
< 0Negative edgeDo not trade this strategy
0 - 0.02No meaningful edgeTransaction costs likely exceed edge
0.02 - 0.10Marginal edgeConservative fractions only
0.10 - 0.20Good edgeStandard fractions appropriate
> 0.20Excellent edgeRare; 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:

AssumptionRealityImpact
Known edge (p, b)Estimated from noisy dataOverbetting risk
Independent betsCorrelated positionsRuin risk increases
Binary outcomesContinuous P&L distributionFormula approximation
Stationary edgeEdge changes over timeStale sizing
No transaction costsSlippage, fees, MEVEffective edge lower
Unlimited divisibilityMinimum position sizesRounding 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.

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Kelly Criterion AI skill do?

Kelly criterion optimal sizing with fractional variants, edge estimation, and practical application for crypto trading

Why use Kelly Criterion on TypingMind?

Because you install it once and use it with any model. Kelly Criterion is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Kelly Criterion in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/agiprolabs/claude-trading-skills/tree/main/skills/kelly-criterion. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Kelly Criterion?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Kelly Criterion?

As many as you like. As long as a model supports skills, you can use Kelly Criterion with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Kelly Criterion AI skill free?

Yes. It is published on GitHub by agiprolabs under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇