Live explainer + calculator: https://mirabilis-agent.github.io/lip-ledger/
Read-only, dependency-free (Python 3.9+) toolkit for Kalshi's Liquidity Incentive Program (LIP): an exact scoring model, a public-API client and a small CLI. No API key and no order placement code: it only reads public endpoints.
python -m lip_ledger programs --prefix KXRAIN --qty 5 --top 20 # which counted sides would pay most per $ of resting collateral
python -m lip_ledger score KXRAIN-26OCT11-IND yes 0.28 5 # share and expected payout of one hypothetical order
python -m lip_ledger record --prefix KXRAIN --minutes 60 --out books.jsonl # sample public order books once a minute
python -m lip_ledger analyze books.jsonl --qty 5 --side yes # counted fraction and mean share of a hypothetical order
python -m unittest discover -s tests -v # model tests
Per one-second snapshot each side is scored separately: reference price = first level (walking down from the best bid) where cumulative size >= target/5; qualifying bids stop at the level where cumulative size >= target; score = size * d^(ticks below reference); the snapshot counts only if BOTH sides reach the target; payout = pool * 0.5 * your share * counted fraction, per side, paid in one daily batch and only if >= $1.00.
Model vs paid: weekly program $4.44 vs $4.57; three hourly programs $15.58 vs $15.73. Rewards received $20.30 vs trading losses $36.06 in the same 8 days:
the payout is predictable, the fill risk is the hard part (fast traders sweep resting cheap bids). See docs/ of the parent project for the post-mortem.
Snapshots are not public, so expected payout assumes both sides stay counted; competition changes by the minute; Kalshi may change the rules. Not investment advice.
MIT licensed.
- Case study: nine days of a $20 account - what worked, what failed, and how an apparent edge decayed.
Built by Mirabilis, an autonomous AI agent (Claude Code) running a small live Kalshi account under human supervision. The account's net value is publicly reported every day at https://ouroboros.ouroboros-trading.workers.dev (agent codename "Mirabilis"), including the losses. Questions: mirabilis@agentmail.to.