← Back to Skills Marketplace
diagnostikon

Kalshi F1 Constructor Trader

by diagnostikon · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
88
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install kalshi-f1-constructor-trader
Description
Trades F1 Drivers Championship markets on Kalshi using constructor (team) car performance ratings. Drivers in faster cars have structurally higher championsh...
README (SKILL.md)

\r \r

Kalshi F1 Constructor Trader\r

\r

This is a template.\r The default signal uses static constructor ratings and driver skill modifiers -- remix it with live qualifying data, FP session lap times, or car development trajectory analysis.\r The skill handles all the plumbing (market discovery, trade execution, safeguards). Your agent provides the alpha.\r \r

Strategy Overview\r

\r Constructor (team) car speed is the single strongest predictor of F1 championship outcomes. A driver in the fastest car wins the championship ~70% of the time historically. This skill rates each constructor's car performance, applies individual driver skill modifiers, and computes fair championship probabilities using a power-law model.\r \r Key advantages:\r

  • Car > driver -- constructor advantage explains most championship variance\r
  • Stable signal -- car performance changes slowly (major upgrades every 3-5 races)\r
  • Markets overweight narratives -- retail traders overreact to single race results while ignoring underlying car pace\r
  • Power-law compounding -- small car advantages compound over a 24-race season\r \r

Signal Logic\r

\r

Constructor Model\r

\r

  1. Rate each constructor's car performance (0-100 scale)\r
  2. Apply individual driver skill modifiers (teammate comparison)\r
  3. Compute effective driver rating = constructor_base + skill_modifier\r
  4. Convert to probabilities: P(win) proportional to rating^3 (power law)\r
  5. Compare model probability to Kalshi market price\r
  6. Trade when |model - market| >= entry_edge\r \r

Constructor Ratings (2025)\r

\r | Constructor | Rating | Notes |\r |-------------|--------|-------|\r | Red Bull | 95 | Top pace, dominant qualifying |\r | McLaren | 92 | Strong race pace, consistent |\r | Ferrari | 90 | Great qualifier, variable race pace |\r | Mercedes | 88 | Improving development trajectory |\r | Aston Martin | 82 | Best of the rest |\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 | 4 | 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-constructor-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_CONSTR_ENTRY_EDGE` | `0.10` | Min divergence to trigger trade |\r
| `SIMMER_F1_CONSTR_EXIT_THRESHOLD` | `0.45` | Sell position when price reaches this level |\r
| `SIMMER_F1_CONSTR_MAX_POSITION_USD` | `5.00` | Max USDC per trade |\r
| `SIMMER_F1_CONSTR_MAX_TRADES_PER_RUN` | `4` | Max trades per execution cycle |\r
| `SIMMER_F1_CONSTR_SLIPPAGE_MAX` | `0.15` | Max slippage before skipping trade |\r
| `SIMMER_F1_CONSTR_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
Usage Guidance
This skill is coherent for live trading, but take standard precautions: 1) Treat SOLANA_PRIVATE_KEY as highly sensitive — prefer a purpose-limited key/account and rotate it if exposed. 2) Test thoroughly in dry-run/paper mode; do not pass --live until you understand position sizing and limits. 3) Verify the simmer-sdk package source (PyPI and GitHub) before installing, and install in an isolated environment. 4) Be aware the skill can import markets and call the Simmer/Kalshi APIs; expect network calls to those services. 5) Note minor docs gaps (some optional env vars like TRADING_VENUE and AUTOMATON_MAX_BET are referenced but not declared); double-check configuration before enabling automated runs.
Capability Tags
cryptorequires-wallet
Capability Assessment
Purpose & Capability
Name/description, required Python dependency (simmer-sdk), and requested credentials (SIMMER_API_KEY and SOLANA_PRIVATE_KEY) align with a tool that discovers Kalshi markets via a Simmer API client and executes trades via a Solana/DFlow flow. The code implements the stated constructor/driver-rating model and trading logic; nothing extraneous (e.g., unrelated cloud credentials) is requested.
Instruction Scope
SKILL.md and trader.py focus on market discovery, model pricing, and trade execution. Minor inconsistencies: the top of SKILL.md initially lists only SIMMER_API_KEY but later and elsewhere (clawhub.json and the Required Credentials table) require SOLANA_PRIVATE_KEY as well. The code also reads optional env vars (e.g., TRADING_VENUE, AUTOMATON_MAX_BET) that are not declared in requires.env; these look optional and used for configuration rather than exfiltration.
Install Mechanism
There is no arbitrary download/install step. The only declared dependency is the simmer-sdk PyPI package (and the repo is referenced). Requiring a package from PyPI is expected for this functionality and is proportionate to the skill's purpose.
Credentials
The skill asks for SIMMER_API_KEY and SOLANA_PRIVATE_KEY, which are appropriate for API access and live Solana transactions respectively. SOLANA_PRIVATE_KEY is highly sensitive but justified for live order execution. A couple of optional env vars (AUTOMATON_MAX_BET, TRADING_VENUE) are used but not listed in requires.env — this is a minor documentation gap rather than an unexplained permission.
Persistence & Privilege
The skill does not request always:true and does not appear to modify other skills or system-wide settings. clawhub.json marks the skill automaton-managed with an entrypoint, but autostart/cron are null, and the skill defaults to dry-run — live trades require an explicit --live flag.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kalshi-f1-constructor-trader
  3. After installation, invoke the skill by name or use /kalshi-f1-constructor-trader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug kalshi-f1-constructor-trader
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Kalshi F1 Constructor Trader?

Trades F1 Drivers Championship markets on Kalshi using constructor (team) car performance ratings. Drivers in faster cars have structurally higher championsh... It is an AI Agent Skill for Claude Code / OpenClaw, with 88 downloads so far.

How do I install Kalshi F1 Constructor Trader?

Run "/install kalshi-f1-constructor-trader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Kalshi F1 Constructor Trader free?

Yes, Kalshi F1 Constructor Trader is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Kalshi F1 Constructor Trader support?

Kalshi F1 Constructor Trader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Kalshi F1 Constructor Trader?

It is built and maintained by diagnostikon (@diagnostikon); the current version is v1.0.0.

💬 Comments