Polymarket 5min, 15min, 1hour Trading Bot — Polymarket Arbitrage Trading Bot & Automation Toolkit

Languages / 语言: English (this page, top to bottom) plus a Simplified Chinese section (简体中文) at the end. / 页面主体为英文,文末提供简体中文完整说明与表格。


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.

(中文摘要) 本仓库提供三个可运行的 Python Polymarket 短线(5m/15mUp/Down 机器人实现,含 WebSocket、下单与风控范式;仅供学习与研究,请优先模拟 / 小资金并自担风险。完整安装、机器人对照表与策略目录见文末 简体中文

Contact (Telegram)@terauss · 联系(Telegram@terauss

This repository is hosted under PolyBullLabs (polymarket-5min-15min-1hour-arbitrage-trading-bot). The org also publishes Rust Polymarket bots on 5m, 15m, and 1h horizons with different strategies than this Python suite—see the table below.

Proof photo_2026-02-26_11-48-37

photo_2026-02-26_11-48-43

photo_2026-02-26_11-48-47

5min-3-6-1 5min-3-6

https://github.com/user-attachments/assets/29ae399d-6ee1-455a-8caf-e30deef7eae7

https://github.com/user-attachments/assets/f17f4012-557d-4e58-ad82-6b705cdbecc0

https://github.com/user-attachments/assets/0e9bfcf2-950a-41bc-8318-a20f8de78866



Additional strategy catalog

The strategies below are examples of directions PolyBull Labs builds or discusses as separate offerings, custom deployments, or research tracks. They are not guaranteed to exist as public drop-ins in this repository—availability, implementation language, and terms are handled individually on Telegram @terauss.

下表为策略方向示例(可定制开发或单独交付),不一定以本仓库公开子目录形式提供;是否落地、技术栈与商务条款请在 Telegram @terauss 沟通。

Strategy (EN) 策略(中文) Idea (EN) 思路(中文)
1c buy 1 美分买入 Seek ultra-cheap bids (near $0.01) when microstructure or book updates create dislocations; high variance, needs hard notional caps and kill switches. 在盘口/流动性短暂失衡时捕捉极低价(约 1 美分)一侧;方差极大,必须配合严格资金上限与熔断。
99c sniper 99 美分狙击 Target near-resolution asks around $0.99 when you believe the outcome is effectively settled but liquidity still prints; tail risk if the market flips. 在临近结算、认为结果已高度确定时参与约 99 美分一侧;若结果反转则尾部风险显著。
Low-side dual reversion 弱势双边均值回归 Work both underdog sides when prices are compressed, betting on mean reversion or late volatility expansion with paired risk controls. 在两侧价格受压时,对弱势/低价双边做均值回归或博弈尾盘波动放大,需配对风控。
Pre-order market 预挂单 / 盘前布局 Place limits ahead of the active window (or refresh ladders early) to shape queue position before competing flow arrives. 在窗口正式激烈博弈之前挂出限价或刷新阶梯,以排队与价位占据主动。
Cross-market bot 跨市场机器人 Link two or more related markets (same asset, different horizons, or correlated events) for hedge, spread, or arbitrage-style books. 多个相关市场(同资产不同周期、或相关事件)联动,做对冲、价差或类套利组合。
Martingale & anti-martingale @ ~45c 约 45¢ 马丁 / 反马丁 Around mid prices (~45¢), either add on adverse moves (martingale-style, very dangerous) or pyramid into strength / cut into weakness (anti-martingale); must be regime-gated. 中段价位(约 45 美分)附近,按规则做亏损加仓(马丁,极高风险)顺势加码 / 逆势减仓(反马丁);必须有行情过滤爆仓防护
Fibonacci strategy bot 斐波那契策略机器人 Size entries or grids using Fibonacci retracement/extension levels relative to a swing anchor; combines TA structure with prediction-market binary payoffs. 以波段锚点计算斐波那契回撤/扩展位,用于分批建仓或网格;将技术结构与二元盈亏不对称结合。
Binary momentum (MACD, RSI, VWAP) 二元动量(MACD / RSI / VWAP Momentum stack on binary Up/Down: MACD for trend impulse, RSI for stretch / mean-revert filter, VWAP for intraday fair value—similar spirit to the shipped VWAP bot but multi-indicator. 在二元 Up/Down 上叠加动量MACD 看趋势动能,RSI 看过热/回调过滤,VWAP 看日内公允;理念接近本仓库 VWAP 机器人但为多指标融合
Dump-hedge 急跌对冲 Detect a sharp dump, leg in, then hedge the other side when combined pair cost clears your edge threshold (see also the Rust 15m repo in Related Rust Polymarket bots). 识别急跌后先进一侧,再在组合成本达标时对冲另一侧锁定结构(亦可对照上文 Rust 15m 仓库的 dump-and-hedge 思路)。


Why traders and developers use this Polymarket bot suite

  • 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 layout (one Python project per bot at the repo root), 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 @terauss. For bots oriented toward live profitability—more advanced signals, sizing, and execution—contact the same channel; availability and terms are discussed individually.



Screenshots & demo

Visual references for dashboards and flows (replace or extend with your own recordings as the Polymarket arbitrage trading bot suite evolves).

VWAP / momentum (BTC binary bot)

https://github.com/user-attachments/assets/4c528411-6d88-4843-adf8-26c26f63288e

Polymarket trading bot VWAP momentum dashboard Polymarket bot terminal UI

Meridian / late consensus (late_v3)

https://github.com/user-attachments/assets/c811e320-3a0a-4cbe-9cec-8b7a42c0cf6d

Polymarket arbitrage trading bot Meridian spread view Prediction market bot multi-asset dashboard

PTB bot (5m / 15m)

https://github.com/user-attachments/assets/bfdf7590-5458-4883-88cf-b8343a316f6f

Polymarket API bot PTB web dashboard Automated trading bot PTB controls

Table of contents


Features

  • 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.

How it works

  1. Connect — Configure wallet/API credentials and Polymarket-compatible endpoints per the bot README (never commit secrets).
  2. Select a market window — Short-horizon 5m / 15m crypto Up/Down markets; parameters differ by polymarket bot (BTC-only vs multi-asset).
  3. Ingest & signal — Live quotes and/or oracle-aligned inputs feed rules (VWAP deviation, late-book skew, PTB vs spot distance, etc.).
  4. 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.


Bots in this repository

All runnable bots live as top-level folders next to this README. Each has its own README, requirements.txt, and configuration (.env / config.json / config.env).

Directory Focus Markets Core idea
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.”
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.
5min-15min-PTB-bot/ PTB diff + probability triggers BTC 5m or 15m Compare live BTC to Polymarkets price-to-beat (PTB); fire when time, dollar diff, and implied probability align; manage risk with take-profit / stop-loss on token prices.

Installation

git clone https://github.com/PolyBullLabs/polymarket-5min-15min-1hour-arbitrage-trading-bot.git
cd polymarket-5min-15min-1hour-arbitrage-trading-bot

Then enter the bot you want and create a virtual environment:

cd btc-binary-VWAP-Momentum-bot   # or: up-down-spread-bot / 5min-15min-PTB-bot
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt

Follow the README inside that bot for exact entrypoints, dependencies, and any extra setup (dashboards, env files).


Usage

  1. Pick a bot folder at the repo root and open its README (e.g. btc-binary-VWAP-Momentum-bot/README.md).
  2. Copy example config / .env as documented; set SIMULATION_MODE or dry run when offered.
  3. Run the documented command (often python main.py or the bot-specific script—see each README).
  4. 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

Configuration is per bot:

  • Environment variables — API keys, RPC URLs, Telegram hooks, simulation flags (see each bots .env.example or 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.

Risk management snapshot

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.

Which Polymarket bot should I run?

Situation Sensible starting point
You want one asset (BTC) and indicator-style rules with a terminal dashboard btc-binary-VWAP-Momentum-bot
You want several coins from one wallet and late-window consensus with structured exits up-down-spread-bot (Meridian)
You care about PTB vs Chainlink BTC and rule-based triggers with a web dashboard 5min-15min-PTB-bot


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.git
  • git clone https://github.com/Poly-Tutor/Polymarket-15min-arbitrage-bot.git
  • git clone https://github.com/Poly-Tutor/1hour-crypto-polymarket-trading-bot.git

Roadmap

  • 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.

FAQ

What is a Polymarket trading bot?

A Polymarket trading bot is software that connects to Polymarkets 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.

Is this a polymarket arbitrage trading bot?

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.

How is this different from a generic crypto trading bot?

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.

Do I need a Polymarket API bot setup?

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 bots README for specifics.

Can I use this as a fully automated trading bot out of the box?

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.

Is this prediction market bot software safe?

Software has bugs; markets have tail risk. Use small size, isolated wallets, and monitoring. Past backtests or demos do not predict live results.

Who is this for?

Developers who want to learn or extend a polymarket bot, and traders who accept that no bot guarantees profit and who will test responsibly.

Where do I get help or custom strategies?

For custom deployment, additional strategies, or professional risk frameworks, contact Telegram @terauss.


Additional strategy catalog

The strategies below are examples of directions PolyBull Labs builds or discusses as separate offerings, custom deployments, or research tracks. They are not guaranteed to exist as public drop-ins in this repository—availability, implementation language, and terms are handled individually on Telegram @terauss.

下表为策略方向示例(可定制开发或单独交付),不一定以本仓库公开子目录形式提供;是否落地、技术栈与商务条款请在 Telegram @terauss 沟通。

Strategy (EN) 策略(中文) Idea (EN) 思路(中文)
1c buy 1 美分买入 Seek ultra-cheap bids (near $0.01) when microstructure or book updates create dislocations; high variance, needs hard notional caps and kill switches. 在盘口/流动性短暂失衡时捕捉极低价(约 1 美分)一侧;方差极大,必须配合严格资金上限与熔断。
99c sniper 99 美分狙击 Target near-resolution asks around $0.99 when you believe the outcome is effectively settled but liquidity still prints; tail risk if the market flips. 在临近结算、认为结果已高度确定时参与约 99 美分一侧;若结果反转则尾部风险显著。
Low-side dual reversion 弱势双边均值回归 Work both underdog sides when prices are compressed, betting on mean reversion or late volatility expansion with paired risk controls. 在两侧价格受压时,对弱势/低价双边做均值回归或博弈尾盘波动放大,需配对风控。
Pre-order market 预挂单 / 盘前布局 Place limits ahead of the active window (or refresh ladders early) to shape queue position before competing flow arrives. 在窗口正式激烈博弈之前挂出限价或刷新阶梯,以排队与价位占据主动。
Cross-market bot 跨市场机器人 Link two or more related markets (same asset, different horizons, or correlated events) for hedge, spread, or arbitrage-style books. 多个相关市场(同资产不同周期、或相关事件)联动,做对冲、价差或类套利组合。
Martingale & anti-martingale @ ~45c 约 45¢ 马丁 / 反马丁 Around mid prices (~45¢), either add on adverse moves (martingale-style, very dangerous) or pyramid into strength / cut into weakness (anti-martingale); must be regime-gated. 中段价位(约 45 美分)附近,按规则做亏损加仓(马丁,极高风险)顺势加码 / 逆势减仓(反马丁);必须有行情过滤爆仓防护
Fibonacci strategy bot 斐波那契策略机器人 Size entries or grids using Fibonacci retracement/extension levels relative to a swing anchor; combines TA structure with prediction-market binary payoffs. 以波段锚点计算斐波那契回撤/扩展位,用于分批建仓或网格;将技术结构与二元盈亏不对称结合。
Binary momentum (MACD, RSI, VWAP) 二元动量(MACD / RSI / VWAP Momentum stack on binary Up/Down: MACD for trend impulse, RSI for stretch / mean-revert filter, VWAP for intraday fair value—similar spirit to the shipped VWAP bot but multi-indicator. 在二元 Up/Down 上叠加动量MACD 看趋势动能,RSI 看过热/回调过滤,VWAP 看日内公允;理念接近本仓库 VWAP 机器人但为多指标融合
Dump-hedge 急跌对冲 Detect a sharp dump, leg in, then hedge the other side when combined pair cost clears your edge threshold (see also the Rust 15m repo in Related Rust Polymarket bots). 识别急跌后先进一侧,再在组合成本达标时对冲另一侧锁定结构(亦可对照上文 Rust 15m 仓库的 dump-and-hedge 思路)。

Extended strategies (separate offerings)

Beyond these three open folders, PolyBull Labs 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. The strategy catalog above summarizes frequently requested tracks in English and Chinese. For access, customization, or collaboration, use Telegram: @terauss.


Disclaimer

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.


License

Individual bots may ship their own LICENSE; where none is specified, treat usage as at your own risk.


Contact


简体中文(Simplified Chinese

项目简介

本仓库是 PolyBullLabs 旗下的 Polymarket 5 分钟 / 15 分钟 / 1 小时相关 Python 交易机器人套件(公开部分为 三个 可运行子项目),面向加密 Up/Down 短期预测市场:含 REST/WebSocket、下单与风控范式,适合学习、二次开发与小资金模拟不构成投资建议;请务必先 dry-run / 模拟,并自行承担全部风险。

本仓库内的机器人(公开目录)

目录 侧重点 市场 核心思路
btc-binary-VWAP-Momentum-bot/ VWAP、偏离、动量、z-score BTC 5m15m 较晚的窄窗口内,当价格站上 VWAP动量为正时倾向强势侧;强调“共识 + 短线延续”过滤。
up-down-spread-bot/Meridian Late Entry V3late_v3 BTC、ETH、SOL、XRP — 5m15m 尾盘若点差与**置信度(卖盘偏斜等)**过关,则跟随订单簿已偏向的一侧;止损 / 翻转止损在到期前截断劣路径。
5min-15min-PTB-bot/ PTB 差值 + 概率触发 BTC 5m15m 对比链上/现货 BTC 与 Polymarket PTBprice-to-beat;在时间、价差、隐含概率共振时触发;可用 TP/SL 管理仓位。

附加策略目录(与上表一致 · EN/中文)

与英文章节 Additional strategy catalog 相同,便于中文读者直接阅读:

Strategy (EN) 策略(中文) Idea (EN) 思路(中文)
1c buy 1 美分买入 Seek ultra-cheap bids (near $0.01) when microstructure or book updates create dislocations; high variance, needs hard notional caps and kill switches. 在盘口/流动性短暂失衡时捕捉极低价(约 1 美分)一侧;方差极大,必须配合严格资金上限与熔断。
99c sniper 99 美分狙击 Target near-resolution asks around $0.99 when you believe the outcome is effectively settled but liquidity still prints; tail risk if the market flips. 在临近结算、认为结果已高度确定时参与约 99 美分一侧;若结果反转则尾部风险显著。
Low-side dual reversion 弱势双边均值回归 Work both underdog sides when prices are compressed, betting on mean reversion or late volatility expansion with paired risk controls. 在两侧价格受压时,对弱势/低价双边做均值回归或博弈尾盘波动放大,需配对风控。
Pre-order market 预挂单 / 盘前布局 Place limits ahead of the active window (or refresh ladders early) to shape queue position before competing flow arrives. 在窗口正式激烈博弈之前挂出限价或刷新阶梯,以排队与价位占据主动。
Cross-market bot 跨市场机器人 Link two or more related markets (same asset, different horizons, or correlated events) for hedge, spread, or arbitrage-style books. 多个相关市场(同资产不同周期、或相关事件)联动,做对冲、价差或类套利组合。
Martingale & anti-martingale @ ~45c 约 45¢ 马丁 / 反马丁 Around mid prices (~45¢), either add on adverse moves (martingale-style, very dangerous) or pyramid into strength / cut into weakness (anti-martingale); must be regime-gated. 中段价位(约 45 美分)附近,按规则做亏损加仓(马丁,极高风险)顺势加码 / 逆势减仓(反马丁);必须有行情过滤爆仓防护
Fibonacci strategy bot 斐波那契策略机器人 Size entries or grids using Fibonacci retracement/extension levels relative to a swing anchor; combines TA structure with prediction-market binary payoffs. 以波段锚点计算斐波那契回撤/扩展位,用于分批建仓或网格;将技术结构与二元盈亏不对称结合。
Binary momentum (MACD, RSI, VWAP) 二元动量(MACD / RSI / VWAP Momentum stack on binary Up/Down: MACD for trend impulse, RSI for stretch / mean-revert filter, VWAP for intraday fair value—similar spirit to the shipped VWAP bot but multi-indicator. 在二元 Up/Down 上叠加动量MACD 看趋势动能,RSI 看过热/回调过滤,VWAP 看日内公允;理念接近本仓库 VWAP 机器人但为多指标融合
Dump-hedge 急跌对冲 Detect a sharp dump, leg in, then hedge the other side when combined pair cost clears your edge threshold (see also the Rust 15m repo in Related Rust Polymarket bots). 识别急跌后先进一侧,再在组合成本达标时对冲另一侧锁定结构(亦可对照英文区 Rust 15m 仓库的 dump-and-hedge 描述)。

克隆与安装(摘要)

git clone https://github.com/PolyBullLabs/polymarket-5min-15min-1hour-arbitrage-trading-bot.git
cd polymarket-5min-15min-1hour-arbitrage-trading-bot
cd btc-binary-VWAP-Momentum-bot   # 或: up-down-spread-bot / 5min-15min-PTB-bot
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt

各子目录另有 README 与示例环境变量,请勿将密钥提交到 Git

相关 Rust 仓库(Poly-Tutor

英文主文档见 Related Rust Polymarket bots (Poly-Tutor):含 5m / 15m / 1hpair-cost、dump-hedge、限价+merge 等 Rust 实现链接与 git clone 命令。

免责声明(中文)

预测市场交易可能导致本金全部亏损。本仓库内容仅供教育与实验;作者与贡献者不对因使用代码产生的交易亏损、程序错误、交易所或协议规则变更、以及您所在司法辖区的合规问题承担责任。非投资建议。无担保。 在充分理解行为与风险前,请持续使用模拟 / 小资金

联系(中文)


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.

若本仓库对您有帮助,欢迎点 Star,方便其他开发者与交易者发现本项目;也欢迎通过 Issue 贡献文档与代码改进。

S
Description
No description provided
Readme 498 KiB
Languages
Python 93.7%
HTML 4.9%
JavaScript 0.9%
CSS 0.5%