What Is Crypto Prediction Executor?
windowsMarketLab built Crypto Prediction Executor as an open-source event-driven execution bot for short-horizon crypto prediction markets. It is one of the best Prediction Market Trading Bots tools for crypto traders, and it tracks BTC, ETH, SOL, and XRP up/down markets on Polymarket CLOB V2 while streaming order books and RTDS prices for four asset classes and short cycle windows such as 5-minute markets.
The point is not signal discovery; it is deterministic execution. Crypto Prediction Executor reads TOML rules, derives the active market slug, and submits bull or bear entries through a Safe-backed proxy wallet when the entry window matches.
Quick Overview
| Attribute | Details |
|---|---|
| Type | Prediction Market Trading Bots |
| Best For | crypto traders |
| Language/Stack | Node.js 20+, TypeScript, @polymarket/clob-client-v2, Polygon RPC, TOML, WebSockets |
| License | MIT |
| GitHub Stars | N/A as of Feb 2026 |
| Pricing | Open-Source |
| Last Release | N/A |
Who Should Use Crypto Prediction Executor?
- Crypto traders running rule-based entries who want a bot that watches live market data and places orders when delta, volatility, and timing conditions line up.
- Backend engineers building Polymarket integrations who need a concrete reference for CLOB V2 signing, market slug derivation, and wallet-funded execution.
- Indie hackers testing short-horizon strategies who prefer a TOML-driven workflow over hard-coded strategy logic.
- Ops-minded teams that care about auditability and want clear logs, repeatable configuration, and a narrow execution path instead of a sprawling multi-exchange stack.
Not ideal for:
- Backtest-heavy quant research where you need historical simulation, walk-forward validation, and parameter sweeps.
- Users who do not want wallet custody risk because Crypto Prediction Executor can submit real orders and requires funded collateral.
- Teams targeting many venues at once since this project is tightly focused on Polymarket CLOB V2 rather than a broad exchange abstraction layer.
Key Features of Crypto Prediction Executor
- Polymarket CLOB V2 execution — Crypto Prediction Executor uses
@polymarket/clob-client-v2and signs orders against the V2 exchange domain. That matters because the runtime path is aligned with the current collateral and signing model instead of legacy flows. - Live order-book and price streaming — The bot subscribes to Polymarket market WebSocket data and RTDS reference prices, then evaluates entry rules against fresh ticks. That gives you event-driven execution instead of polling a stale snapshot.
- TOML-based strategy configuration — Trade logic lives in
trade.toml, which keeps market selection, thresholds, and timing windows outside the codebase. You can tune entries without touching the TypeScript runtime, which is useful for rapid iteration. - Market slug derivation — The executor derives the active market slug from the configured asset and period before resolving token IDs from Gamma market data. That reduces manual mapping errors when the cycle rolls forward.
- Proxy-wallet trading path — Orders are sent through a proxy wallet with pUSD collateral, which matches the current Polymarket CLOB V2 requirements. This is a hard constraint, not a cosmetic detail, and the project calls out that USDC.e is not the active collateral.
- Inspectable runtime modes —
npm run start:dev,npm run start:log, andnpm run inspectgive you separate execution, logging, and wallet-activity workflows. That helps when you are debugging fills or verifying that a configured market is live. - Narrow asset coverage with explicit rules — The current implementation focuses on BTC, ETH, SOL, and XRP up/down markets. That small surface area makes the timing logic easier to reason about than a generic, multi-venue trading daemon.
Crypto Prediction Executor vs Alternatives
| Tool | Best For | Key Differentiator | Pricing |
|---|---|---|---|
| Crypto Prediction Executor | Polymarket short-horizon execution | Direct CLOB V2 support, RTDS streams, and TOML-defined entry windows | Open-Source |
| Hummingbot | Multi-exchange market making | Broad connector ecosystem and mature liquidity strategies | Open-Source |
| Freqtrade | Crypto strategy research and live trading | Python strategy engine with backtesting and hyperopt | Open-Source |
Custom @polymarket/clob-client-v2 script | One-off Polymarket integrations | Minimal code, full control, no framework overhead | Open-Source / internal time |
Pick Crypto Prediction Executor when your target is Polymarket and your edge depends on timing the last seconds of a market cycle. Pick Hummingbot when you need exchange breadth and market-making workflows across many venues.
Pick Freqtrade when historical research, portfolio optimization, and backtesting matter more than venue-specific execution. Pick a custom @polymarket/clob-client-v2 script when you want the smallest possible codebase and are happy to own retries, logging, and state management yourself.
For operators who want execution traces and post-trade evidence, pair Crypto Prediction Executor with OpenTrace for span-level tracing and DataHaven for durable log retention. If you are comparing adjacent automation stacks, you can also browse all CLI Tools for workflow pieces that fit around a trading bot.
How Crypto Prediction Executor Works
Crypto Prediction Executor is built as a small state machine around a single market cycle. It loads .env and trade.toml, creates or derives Polymarket CLOB credentials, resolves the active market slug, and then subscribes to two live streams: the market order book and the reference crypto price feed. The design choice is clear: keep decision-making in config, keep execution in a single process, and keep the feedback loop tied to real market events rather than scheduled polling.
Under the hood, the runtime uses the Polymarket V2 client with chain, signer, creds, signatureType, and funderAddress. That means order placement is aligned with the current exchange contract model, the proxy wallet is explicit, and the strategy can reason about pUSD collateral before sending a trade. The flow is deterministic enough for short-horizon entries and narrow enough that you can audit every branch that leads to a fill.
cp .env.example .env
npm install
npm run start:dev
The first command creates local configuration, the second installs dependencies, and the third starts the live executor in development mode. After that, the bot watches the configured market, evaluates delta and volatility thresholds, and submits a bull or bear order only when the TOML rule matches the remaining seconds in the cycle.
Pros and Cons of Crypto Prediction Executor
Pros:
- Direct Polymarket CLOB V2 support keeps the runtime aligned with the current exchange API and signing model.
- Rule files are human-readable because the strategy lives in TOML instead of buried inside callback code.
- Event-driven execution reduces latency between market movement and order submission compared with periodic polling.
- Explicit collateral handling forces the operator to fund pUSD correctly, which avoids silent failures caused by legacy balance assumptions.
- Focused asset scope makes the code easier to reason about and test than a multi-venue bot.
- Inspection mode exists so you can verify wallet activity without immediately changing trade logic.
Cons:
- Venue lock-in is real because the project is built for Polymarket CLOB V2, not a generic exchange abstraction.
- No built-in backtesting pipeline means you need external tooling if you want historical validation.
- Wallet custody is part of the workflow and the bot can submit real orders, so operational mistakes have financial consequences.
- Collateral setup is strict because API-only users must use pUSD and cannot rely on old USDC.e assumptions.
- Strategy scope is narrow since the current market list is limited to four crypto assets and short-horizon cycles.
Getting Started with Crypto Prediction Executor
The fastest path is to clone the repo, install dependencies, fill in the wallet and RPC settings, and then launch the development runner. You need Node.js 20 or newer, a Polygon RPC endpoint, Polymarket CLOB access, and a proxy wallet funded with pUSD before the first live order can succeed.
cp .env.example .env
npm install
npm run start:dev
npm run inspect
After the first run, the executor loads trade.toml, resolves the market slug, and begins listening to order-book and price streams. If you are tuning the strategy, adjust market_coin, market_period, and the entry windows in trade.toml, then rerun the process to confirm that the configured rules match the intended cycle.
Verdict
Crypto Prediction Executor is the strongest option for rule-based Polymarket CLOB V2 execution when you want deterministic entry timing and can tolerate a narrow venue. Its main strength is direct, config-driven access to live order books and reference prices; the caveat is wallet risk and limited exchange scope. Use it if Polymarket is your target, not if you need generic multi-exchange infrastructure.



