\r \r

Kalshi F1 Race Momentum Trader\r

\r

This is a template.\r The default signal uses static recent results -- remix it with live F1 API data for automatic momentum recalculation after each race weekend.\r The skill handles all the plumbing (market discovery, trade execution, safeguards). Your agent provides the alpha.\r \r

Strategy Overview\r

\r Recent form matters in F1. A driver on a hot streak (wins, podiums in the last 3 races) has demonstrably higher championship probability than their season-long average suggests. Markets are slow to fully price in momentum shifts -- they anchor to pre-season expectations and lag behind recent performance changes.\r \r Key advantages:\r

• Recency bias is real and quantifiable -- last 3 races predict next-race performance better than season average\r
• Markets anchor to narratives -- "Verstappen always wins" persists even during cold streaks\r
• Weighted recency -- most recent race gets 3x weight, capturing acceleration/deceleration in form\r
• Hot/cold classification -- simple trend labels (HOT/COLD/FLAT) identify tradeable regimes\r \r

Signal Logic\r

\r

Momentum Model\r

\r

1. Collect last 3 race results per driver (position finished)\r
2. Convert positions to performance scores: P1=1.0, P20=0.0\r
3. Apply recency weights: [3x, 2x, 1x] for [most recent, second, third]\r
4. Compute momentum score: normalized to [-1.0, +1.0]\r
5. Adjust base probability: adjusted = base + momentum * SCALE * base\r
6. Compare adjusted probability to Kalshi market price\r
7. Trade when |adjusted - market| >= entry_edge\r \r

Momentum Categories\r

\r | Momentum Score | Category | Meaning |\r |---------------|----------|---------|\r | > +0.3 | HOT | Driver outperforming, probability should be higher |\r | -0.3 to +0.3 | FLAT | Stable form, no momentum edge |\r | \x3C -0.3 | COLD | Driver underperforming, probability should be lower |\r \r

Conviction-Based Sizing\r

\r

• conviction = min(|edge| / entry_edge, 2.0) / 2.0\r
• size = max($1.00, conviction * MAX_POSITION_USD)\r
• Larger edge = larger position, capped at MAX_POSITION_USD\r \r

Risk Parameters\r

\r | Parameter | Default | Notes |\r |-----------|---------|-------|\r | Entry edge | 10% | Min model-vs-market divergence to trade |\r | Exit threshold | 45% | Sell when position price reaches this |\r | Max position size | $5.00 USDC | Per market |\r | Max trades per run | 5 | Rate limiting |\r | Max slippage | 15% | Skip if slippage exceeds |\r | Min liquidity | $0 | Disabled by default |\r \r

Installation & Setup\r

\r

clawhub install kalshi-f1-race-momentum-trader\r
```\r
\r
Requires: `SIMMER_API_KEY` and `SOLANA_PRIVATE_KEY` environment variables.\r
\r
## Cron Schedule\r
\r
Cron is set to `null` -- the skill does not run on a schedule until you configure it in the Simmer UI.\r
\r
## Safety & Execution Mode\r
\r
**The skill defaults to dry-run mode. Real trades only execute when `--live` is passed explicitly.**\r
\r
| Scenario | Mode | Financial risk |\r
|----------|------|----------------|\r
| `python trader.py` | Dry run | None |\r
| Cron / automaton | Dry run | None |\r
| `python trader.py --live` | Live (Kalshi via DFlow) | Real USDC |\r
\r
## Required Credentials\r
\r
| Variable | Required | Notes |\r
|----------|----------|-------|\r
| `SIMMER_API_KEY` | Yes | Trading authority. Treat as a high-value credential. |\r
| `SOLANA_PRIVATE_KEY` | Yes | Base58-encoded Solana private key for live trading. |\r
\r
## Tunables (Risk Parameters)\r
\r
| Variable | Default | Purpose |\r
|----------|---------|---------|\r
| `SIMMER_F1_RACEMOM_ENTRY_EDGE` | `0.10` | Min divergence to trigger trade |\r
| `SIMMER_F1_RACEMOM_EXIT_THRESHOLD` | `0.45` | Sell position when price reaches this level |\r
| `SIMMER_F1_RACEMOM_MAX_POSITION_USD` | `5.00` | Max USDC per trade |\r
| `SIMMER_F1_RACEMOM_MAX_TRADES_PER_RUN` | `5` | Max trades per execution cycle |\r
| `SIMMER_F1_RACEMOM_SLIPPAGE_MAX` | `0.15` | Max slippage before skipping trade |\r
| `SIMMER_F1_RACEMOM_MIN_LIQUIDITY` | `0` | Min market liquidity USD (0 = disabled) |\r
\r
## Dependency\r
\r
`simmer-sdk` is published on PyPI by Simmer Markets.\r
- PyPI: https://pypi.org/project/simmer-sdk/\r
- GitHub: https://github.com/SpartanLabsXyz/simmer-sdk\r
- Publisher: [email protected]\r