Polymarket trading bot tooling for short-horizon crypto Up / Down markets: this repo ships three production-style Python Polymarket bot implementations you can run, study, and extend. Whether you search for a polymarket arbitrage trading bot, a prediction market bot, or a Polymarket API bot for automated execution, you get readable strategies, WebSocket market data, and CLOB-style order flow patterns built for speed and reliability in research and live-like testing.
This suite is educational and experimental. Use simulation / dry-run first, size small, and own your risk.
| Resource | Link |
|---|---|
| Repository | github.com/Poly-Tutor/polymarket-arbitrage-trading-bot-tools |
| Contact (Telegram) | @AlterEgo_Eth |
The Poly-Tutor org also publishes Rust Polymarket bots on 5m, 15m, and 1h horizons with different strategies than this Python suite—see the table below.
This repository is the Python toolkit (VWAP, Meridian, PTB). The same org maintains separate repos optimized for pair-cost / hedging, dump-and-hedge, and hourly pre-limit + merge flows.
| Timeframe | Repository | Language | Strategy (summary) |
|---|---|---|---|
| 5 min | 5min-btc-polymarket-trading-bot | Rust | BTC 5m Up/Down: lock when combined cost per pair stays under your cap (e.g. Up + Down < $1), plus hedging, expansion when the opposite side rises, ride-the-winner, and PnL rebalance. |
| 15 min | Polymarket-15min-arbitrage-bot | Rust | 15m Up/Down (BTC, ETH, SOL, XRP): dump-and-hedge—detect a sharp drop, leg in, then hedge when pair cost meets targets; optional production CLOB mode. |
| 1 hour | 1hour-crypto-polymarket-trading-bot | Rust | Hourly Up/Down (BTC, ETH, SOL, XRP, Eastern Time): limit buys on both sides before the hour, optional merge for a small locked edge, risk exit if only one side fills. |
Clone URLs:
git clone https://github.com/Poly-Tutor/5min-btc-polymarket-trading-bot.gitgit clone https://github.com/Poly-Tutor/Polymarket-15min-arbitrage-bot.gitgit clone https://github.com/Poly-Tutor/1hour-crypto-polymarket-trading-bot.git
- Automation-first: Each automated trading bot targets repeatable rules instead of manual clicking—ideal if you want a crypto trading bot workflow on a prediction market bot stack.
- Execution-aware design: FAK/FOK patterns, retries, caps, and dashboards where applicable—built for traders who care about latency, fills, and guardrails.
- Three philosophies: Microstructure + VWAP (BTC), multi-asset late consensus (BTC/ETH/SOL/XRP), and oracle-vs-strike (PTB)—so you can compare approaches in one Polymarket trading bot codebase.
- Developer-friendly: Clear Python layout, per-bot READMEs, and env-driven config—extend signals or wire your own arbitrage bot and Polymarket API bot integrations.
If you want additional strategies, custom deployment, or professional risk and sizing beyond this public suite, reach out on Telegram @AlterEgo_Eth. For bots oriented toward live profitability—more advanced signals, sizing, and execution—contact the same channel; availability and terms are discussed individually.
- More Polymarket bots from Poly-Tutor (other strategies)
- Features
- How it works
- Bots in this repository
- Installation
- Usage
- Configuration
- Screenshots & demo
- Risk management snapshot
- Which Polymarket bot should I run?
- Roadmap
- FAQ
- Extended strategies (separate offerings)
- Disclaimer
- License
- Contact
- Multi-strategy Polymarket trading bot collection — VWAP/momentum, late-window consensus with structured exits, and PTB-driven triggers.
- Polymarket API bot patterns — REST + WebSocket usage, order execution helpers, and configs suitable for paper and small live tests.
- Risk controls — dry run / simulation modes, investment caps, stop-loss and flip-stop (where implemented), entry windows, and spread or confidence gates.
- Dashboards & UX — Rich terminal UI (VWAP bot), web dashboards (PTB and Meridian paths), logging for operational review.
- Educational depth — Mechanics explained (why entries can work and how they can fail); aimed at serious traders and builders, not hype.
- Connect — Configure wallet/API credentials and Polymarket-compatible endpoints per the bot README (never commit secrets).
- Select a market window — Short-horizon 5m / 15m crypto Up/Down markets; parameters differ by polymarket bot (BTC-only vs multi-asset).
- Ingest & signal — Live quotes and/or oracle-aligned inputs feed rules (VWAP deviation, late-book skew, PTB vs spot distance, etc.).
- Execute with guardrails — Orders respect caps, max prices, simulation flags, and stop logic—treat this as an automated trading bot with explicit failure modes, not magic alpha.
None of this is investment advice; it is mechanics and software behavior.
All runnable bots live under bots/. Each folder has its own README, requirements.txt, and configuration (.env / config.json / config.env).
| Directory | Focus | Markets | Core idea |
|---|---|---|---|
bots/btc-binary-VWAP-Momentum-bot/ |
VWAP, deviation, momentum, z-score | BTC 5m or 15m | Enter the favorite when price has pulled above VWAP with positive momentum in a late, narrow window—filtering for “consensus + short-term continuation.” |
bots/up-down-spread-bot/ (Meridian) |
Late Entry V3 (late_v3) |
BTC, ETH, SOL, XRP — 5m or 15m | In the last minutes, buy the side the book already favors, if spread and confidence (ask skew) pass checks; stop-loss and flip-stop cut bad paths before expiry. |
bots/5min-15min-PTB-bot/ |
PTB diff + probability triggers | BTC 5m or 15m | Compare live BTC to Polymarket’s price-to-beat (PTB); fire when time, dollar diff, and implied probability align; manage risk with take-profit / stop-loss on token prices. |
Suite index: bots/README.md.
git clone https://github.com/Poly-Tutor/polymarket-arbitrage-trading-bot-tools.git
cd polymarket-arbitrage-trading-bot-toolsThen enter the bot you want and create a virtual environment:
cd bots/<bot-folder>
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -r requirements.txtFollow the README inside that bot for exact entrypoints, dependencies, and any extra setup (dashboards, env files).
- Pick a bot under
bots/and open its README (e.g.bots/btc-binary-VWAP-Momentum-bot/README.md). - Copy example config /
.envas documented; setSIMULATION_MODEor dry run when offered. - Run the documented command (often
python main.pyor the bot-specific script—see each README). - Monitor logs and dashboards; scale size only after you trust behavior end-to-end.
Operational hygiene: dedicated wallet, never commit keys, private RPC where relevant, monitor logs, start with minimum size.
Configuration is per bot:
- Environment variables — API keys, RPC URLs, Telegram hooks, simulation flags (see each bot’s
.env.exampleor README). - JSON / config files — Market choice, windows, price bands, bet sizing, stop-loss and flip-stop parameters.
- Runtime flags — Some bots expose CLI flags (e.g. web dashboard); check the bot README.
You can run more than one polymarket trading bot only if you understand collateral, nonce / rate limits, and position overlap—typically use separate wallets or non-overlapping markets.
Visual references for dashboards and flows (replace or extend with your own recordings as the Polymarket arbitrage trading bot suite evolves).
how.to.run.btc-binary-VWAP-Momentum-bot-new.mp4
how.to.run.up-down-spread-bot-new.mp4
how.to.run.5min-15min-PBT-bot-new.mp4
| Bot | Primary levers |
|---|---|
| VWAP / momentum | Price band (min_price / max_price), narrow entry window, bet size, optional hedge (opposite-side GTD), FAK execution with retries, max entry price cap. |
| Meridian | Dry run, max order / total investment, entry window, confidence and spread gates, stop-loss, flip-stop, entry frequency, FAK / FOK execution behavior. |
| PTB bot | Simulation mode, per-trade USDC, TP/SL on probability, trigger windows, market lag limits, loop cadence. |
| Situation | Sensible starting point |
|---|---|
| You want one asset (BTC) and indicator-style rules with a terminal dashboard | bots/btc-binary-VWAP-Momentum-bot |
| You want several coins from one wallet and late-window consensus with structured exits | bots/up-down-spread-bot (Meridian) |
| You care about PTB vs Chainlink BTC and rule-based triggers with a web dashboard | bots/5min-15min-PTB-bot |
- Broader paper-trading defaults and clearer “first run” checklists per bot.
- Additional observability (structured logs, optional metrics hooks) for production-minded users of this crypto trading bot toolkit.
- Documentation cross-links and version pins where it helps reproducibility.
- Community-driven examples (strategies as plugins) where it fits the architecture.
A Polymarket trading bot is software that connects to Polymarket’s APIs, reads market data, and places or manages orders according to rules—so you can automate entries, exits, and risk limits instead of trading only by hand.
This repository is framed as polymarket arbitrage trading bot tooling: strategies that seek edge in short-horizon Up/Down markets using execution and timing rules. It is not a guarantee of arbitrage in the strict sense on every tick—slippage, fees, and adverse selection apply.
A crypto trading bot on CEXes trades spot or perps; this suite is built for prediction market mechanics on Polymarket (binary outcomes, CLOB, resolution). The overlap is automation and risk controls; the market model is different.
Yes, for serious automation you should plan for API keys, signing, and rate-limit-aware clients. These bots follow Polymarket API bot patterns (REST/WebSocket, order helpers)—see each subfolder README for specifics.
You can run the code and automation paths, but you must configure markets, sizes, and risk. Start with simulation / dry-run, validate fills and logs, then scale. No automated trading bot removes market or operational risk.
Software has bugs; markets have tail risk. Use small size, isolated wallets, and monitoring. Past backtests or demos do not predict live results.
Developers who want to learn or extend a polymarket bot, and traders who accept that no bot guarantees profit and who will test responsibly.
For custom deployment, additional strategies, or professional risk frameworks, contact Telegram @AlterEgo_Eth.
Beyond these three open folders, AlterEgo Eth works on advanced quant-style ideas (sizing sequences, TA combinations, execution-aware models, inventory/skew concepts, Monte Carlo for drawdown, etc.). These are not all shipped as drop-in modules here. For access, customization, or collaboration, use Telegram: @AlterEgo_Eth.
Trading prediction markets can result in total loss of capital deployed. Everything here is provided for education and experimentation. Authors and contributors are not responsible for trading losses, bugs, exchange or protocol rule changes, or regulatory issues in your jurisdiction.
Not financial advice. No warranty. Use simulation / dry-run until you trust the full stack.
Individual bots may ship their own LICENSE; where none is specified, treat usage as at your own risk.
- Telegram: @AlterEgo_Eth
If this Polymarket trading bot toolkit is useful, please star the repo to improve discoverability for other builders and traders—and open issues if you want to contribute improvements to docs or code.
