\r \r

Kalshi Crypto Correlation Trader\r

\r

This is a template. \r The default signal uses a static BTC/ETH beta of 1.3 -- remix it with rolling correlation windows, multi-asset cointegration, or real-time price feed APIs. \r The skill handles all the plumbing (market discovery, trade execution, safeguards). Your agent provides the alpha.\r \r

Strategy Overview\r

\r BTC and ETH are highly correlated, but ETH markets on Kalshi lag BTC moves by hours. This skill monitors BTC price-level markets as a leading indicator, computes ETH fair values using beta=1.3, and trades when ETH markets have not yet adjusted.\r \r Key advantages:\r

• Well-documented correlation -- BTC/ETH beta is stable around 1.3\r
• ETH lags BTC -- retail-dominated Kalshi ETH markets update slowly\r
• Cross-asset signal -- uses BTC as a free leading indicator for ETH trades\r \r

Signal Logic\r

\r

Correlation Model\r

\r

1. Fetch BTC and ETH price-level markets\r
2. Compute BTC sentiment from average market probabilities\r
3. Apply beta=1.3 to derive ETH fair value adjustment\r
4. Compare adjusted fair value to ETH market price\r
5. Trade when |fair - market| >= entry_edge\r \r

Remix Ideas\r

\r

• Rolling beta: Compute 30-day rolling BTC/ETH beta from price data\r
• Multi-asset: Add SOL, AVAX correlations for broader signal\r
• Real-time feeds: Use CoinGecko/Binance API for live price correlation\r
• Regime detection: Different beta in bull vs bear markets\r \r

Risk Parameters\r

\r | Parameter | Default | Notes |\r |-----------|---------|-------|\r | Entry edge | 10% | Min fair-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 | 3 | 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-crypto-correlation-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
The automaton cron is set to `null` -- it does not run on a schedule until you configure it in the Simmer UI. `autostart: false` means it won't start automatically on install.\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
All risk parameters are declared in `clawhub.json` as `tunables` and adjustable from the Simmer UI without code changes.\r
\r
| Variable | Default | Purpose |\r
|----------|---------|---------|\r
| `SIMMER_CRYPTO_CORR_ENTRY_EDGE` | `0.10` | Min divergence between fair value and market to trigger trade |\r
| `SIMMER_CRYPTO_CORR_EXIT_THRESHOLD` | `0.45` | Sell position when price reaches this level |\r
| `SIMMER_CRYPTO_CORR_MAX_POSITION_USD` | `5.00` | Max USDC per trade |\r
| `SIMMER_CRYPTO_CORR_MAX_TRADES_PER_RUN` | `3` | Max trades per execution cycle |\r
| `SIMMER_CRYPTO_CORR_SLIPPAGE_MAX` | `0.15` | Max slippage before skipping (0.15 = 15%) |\r
| `SIMMER_CRYPTO_CORR_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
\r
Review the source before providing live credentials if you require full auditability.\r