One execution core. One risk layer. Every venue. Ten strategy bots share a single engine and a venue-agnostic adapter stack — adding a market means writing one adapter, not rebuilding a bot. Twenty venues are mapped to that interface, each with its own repo.
Quick Start • Strategies • Managed Service • Venue Coverage • Engine • Safety • Contact
No Rust toolchain needed. Grab a prebuilt binary from the latest release — Linux (x86_64 / aarch64), macOS (Intel / Apple Silicon), Windows — verify the SHA256, and you're running in about a minute:
tar -xzf polymarket-toolkits-<tag>-<target>.tar.gz
cd polymarket-toolkits-<tag>-<target>
cp config.yaml.example config.yaml # credentials; config.json ships with the archive
./polymarket-toolkits run copy-trading # dry-run: enable_trading is false by defaultThe archive ships config.json (public settings) alongside config.yaml.example (credentials). Run ./polymarket-toolkits --help for the full command list, or launch with no subcommand for the interactive TUI.
Prefer to build it? cargo install --git https://github.com/HarrierOnChain/Prediction-Markets-Trading-Bot-Toolkits
|
Open-source engine, your keys, your wallet. # 1. Clone the engine (the trading code lives here)
git clone https://github.com/HarrierOnChain/Prediction-Markets-Trading-Bot-Toolkits
cd Prediction-Markets-Trading-Bot-Toolkits
# 2. Configure — credentials from the example
cp config.yaml.example config.yaml
# 3. Dry-run first (no real orders)
cargo run --release -- run copy-tradingEvery bot ships with |
Not sure which strategy fits your venue, capital size, or risk budget? Ask.
|
| 🎯 Strategies | ⚙️ Engine | 🧪 Dry-run |
|---|---|---|
| 10 | Rust | Every path |
Star and fork counts are live badges, not numbers typed into a README — they track the repo and can't drift. No fake testimonials, no cherry-picked P&L.
Ten strategies, one execution core. Each targets a distinct, well-defined market edge, and every one of them runs on the same engine: a Polymarket CLOB client, an order executor with EIP-712 signing and a real dry-run path, a risk guard, position monitor and store, market cache, and on-chain ingestion off Polygon logs. Pick the edge that fits your thesis — the infrastructure underneath is shared.
📦 Every bot runs on the shared engine and safety layer, with full dry-run support. The per-venue repos hold venue metadata — the trading code is here.
| # | Strategy | Edge in one line | Key spec |
|---|---|---|---|
| 1 | 🎯 Copy Trading | Mirror wallets that already proved they have alpha | Multi-wallet · FAK/GTD · circuit breaker |
| 2 | ⚡ BTC 5m / 15m / 1hr Arbitrage | Speed on short-window BTC Up/Down | FAK · short-window |
| 3 | 💰 Cross-Market Arbitrage | Lock the spread, not the direction | Polymarket ↔ Kalshi ↔ PredictIt · hedged legs |
| 4 | 🎯 Directional Arbitrage | Arb base (Up + Down < $1), then tilt toward the side with more edge | Hedged base · limit-only |
| 5 | 📈 Spread Farming | A thousand 0.5¢ wins compound into one number | Bid-ask capture · per-trade P&L |
| 6 | 🏆 Sports Execution | Click. Filled. Done | NBA / NFL / Soccer · FAK |
| 7 | 🎯 Resolution Sniper | 95¢ near-certainty → guaranteed $1.00 payout | Certainty scan · hold to resolution |
| 8 | 📊 Orderbook Imbalance | The signal is the order book — no external feeds | Live OBI · 500ms refresh |
| 9 | 💰 Market Making | Be the house, not the gambler | Two-sided GTD · inventory skew |
| 10 | ⚡ On-Chain Whale Signal | Ahead of the public positions API | Polygon block sub · ABI calldata decode |
How the flagship edges actually work (click to expand)
🎯 Copy Trading — Point the bot at one or more wallets with a proven on-chain record. It mirrors their fills at your chosen scale, with per-wallet caps, FAK/GTD order types, and a circuit breaker that halts on abnormal bursts. Pick who to follow from any wallet with a verifiable on-chain record.
💰 Cross-Market Arbitrage — The same real-world question is often listed on Polymarket, Kalshi and PredictIt at slightly different prices. The engine matches the same contract across venues (strict matching — no fuzzy false pairs), and captures the gap only when it beats round-trip fees. Cross-listed markets are mostly efficient, so this is a patience game: it waits for a real dislocation instead of forcing trades.
🎯 Directional Arbitrage — Buy the Yes + No basket while it costs under $1 (a structural arb base), then tilt extra size onto the side with more upside. Limit-only, hedged base — structure improves expected value instead of betting on a hunch.
🎯 Resolution Sniper — Scan for near-certainty contracts (e.g. 95¢+) where the market has effectively resolved but hasn't paid out, and hold to $1.00. High win-rate, low per-trade return — it compounds on volume, not on swings.
📊 Orderbook Imbalance — No external feeds, no oracle: the signal is the book. Near-touch bid/ask depth skew becomes a short-term directional read, refreshed every 500ms.
💬 Want a strategy explained for your venue or capital size? → t.me/HarrierOnChain
⏸️ The hosted service is not currently open. It ran as a paper-trading beta — simulated funds, no real custody — and is offline while the infrastructure moves. It never handled real money, and live trading was always gated behind custody, security audit and licensing. Sign-ups and pricing are closed for now, so the way to use this project today is to run it yourself with your own keys (see Run the bots yourself).
If you want to talk about a managed setup when it reopens — or about running the engine at size yourself — that conversation happens on Telegram:
The engine is venue-agnostic by design: any platform exposing an order book or position feed plugs in through a single adapter, so adding a market means writing one adapter rather than rebuilding a bot.
Twenty venues are mapped to that interface, each with a repo of its own. Polymarket is the reference implementation the engine is built and tested against; the per-venue repos hold venue metadata, so clone this repo for the trading code.
| Venue | Type | Strategies |
|---|---|---|
| Polymarket | Decentralized (Polygon / USDC) | Reference implementation — all ten |
| Venue | Type |
|---|---|
| Kalshi | CFTC-regulated (US) |
| PredictIt | Academic / US politics |
| Robinhood Predictions | Brokerage-integrated |
| Crypto.com Predictions | Crypto-integrated |
| OG.com | Social / multi-outcome |
| DraftKings Predictions | Sports |
| FanDuel Predicts | Sports |
| Fanatics Markets | Sports / entertainment |
| Interactive Brokers ForecastTrader | Financial events |
| Venue | Chain / Type |
|---|---|
| Limitless | On-chain order book |
| Drift BET | Solana |
| Azuro | Decentralized protocol |
| Augur | Ethereum |
| Myriad Markets | Crypto |
| Hedgehog Markets | Solana / social |
| Zeitgeist | Polkadot |
| Projection Finance | Volatility / sims |
| Better Fan | Sports / esports |
| Manifold Markets | Play-money · consensus signal |
Want a venue prioritized? Adapter work is demand-driven — if you trade a platform you'd like wired up next, reach out on Telegram and it can move up the queue.
Rust, async on Tokio, one execution core behind every strategy and venue. The adapter stack means a new market is one adapter — not a new bot.
| Event processing | < 1ms per event |
| Order execution | < 100ms end-to-end |
| Position polling | ~200ms per wallet |
| Memory | ~50MB baseline |
| CPU | < 5% on modern hardware |
| Concurrency | Semaphore-based rate limiting (default: 25 req / 10s) |
| Circuit Breaker | Auto-halts after N consecutive large trades inside a configurable window |
| Depth Guard | Validates orderbook liquidity before every order |
| Dry Run | Full execution path runs without placing real orders |
| Trade Floor | Minimum size enforcement against negative-EV micro-trades |
The circuit breaker fires when consecutive large trades exceed the configured threshold, or when orderbook depth falls below the minimum. Once tripped, execution is blocked for the cooldown duration. Trip state and cooldown are logged and visible in the TUI.
Recommendations:
| Stage | Action |
|---|---|
| Initial setup | Run with enable_trading: false for a full session |
| First real trades | Keep copy_percentage at 5–10% until you trust the signal |
| Ongoing | Watch circuit breaker trips — they surface execution anomalies |
| Production | Dedicated wallet with only the capital you intend to deploy |
Built and maintained actively. Whether you want to run the bots, request a new venue adapter, or just talk Polymarket tooling and algorithmic strategies — reach out.
| Platform | Link |
|---|---|
| Telegram | t.me/HarrierOnChain |
| Discussions | GitHub Discussions |
Response time is typically within a few hours. Open to questions, feedback, venue requests, and serious collaborations.
Trading prediction markets involves real financial risk. This software is provided as-is, without warranty or guarantee of any outcome. It is not financial advice. Always test with
enable_trading: falsebefore deploying real capital. Check the source for the current state of each strategy before running it with real capital. The managed / copy-trading service is currently closed — it ran in paper mode (simulated funds), never custodied real money, and any future live-trading rollout will follow proper custody, audit, and licensing. Ensure compliance with each venue's terms of service and applicable regulations in your jurisdiction.
