openclaw-polymarket-ai-arbitrage-trading-bot

OpenClaw Polymarket AI Trading Bot(BTC 5m / 15m) — CLOB Arbitrage

OpenClaw Polymarket AI arbitrage trading bot for short-horizon crypto prediction markets (BTC, ETH, SOL, XRP) — built with Node.js 20+ and TypeScript.
If you are searching for “Polymarket AI trading bot”, “OpenClaw trading bot”, “Polymarket BTC 5 minute bot”, “Openclaw Polymarket BTC 5 minute bot”, “Polymarket BTC 15 minute bot”, or “Polymarket CLOB bot”, this repo is a practical starting point.

This bot trades Polymarket Up/Down markets on the Polymarket CLOB (order book) using the official @polymarket/clob-client-v2 SDK.
It runs one market window at a time (configured by coin + period, e.g. BTC 5m or BTC 15m), polls prices, applies rule-based entry/exit strategies, and places orders with retries, cooldowns, and operator-friendly logging.
It includes an OpenClaw-style AI decision layer (deterministic by default, optional HTTP/LLM integration) designed for pluggable signal research.
This is automation scaffolding for experimentation and operations — not a promise of “risk-free arbitrage” profits.

Table of contents

• What this bot does
• Who this is for
• How it differs from “classic” two-window arbitrage
• Architecture
• Key modules
• Quick start
• Environment variables
• trade.toml reference
• Operations and risk management
• Troubleshooting
• Safety and compliance
• FAQ
• Keywords

What this bot does

• Market selection — Builds Polymarket slugs from [market].market_coin and [market].market_period (e.g. BTC + 5m or BTC + 15m short markets).
• Pricing — Polls Gamma / CLOB-backed pricing for UP and DOWN outcome tokens.
• Strategies — Runs trade_1 or trade_2 rules from trade.toml (time/price exits, range entries, optional emergency swap after a sell).
• OpenClaw-style decision layer (optional) — When enabled, runs a deterministic, explainable decision module alongside the existing rules (pluggable scaffolding; not a promise of profit).
• Execution — Submits market-style orders via the v2 CLOB client with instant retries only for transient errors, entry cooldown after failed buys, and friendly error summaries (no raw stack spam).
• Auth — L1 wallet signing to derive or create API credentials, then L2 authenticated client for balance and orders.
• Operator UX — Startup banner, structured logging (emojiprint-logger), and trend / position legends in the console.

If you are looking specifically for a synchronized dual-window (5m + 15m) paired-leg arbitrage engine, that is not what this codebase implements today; see How it differs.
This repo is still in the same “Polymarket arbitrage bot / Polymarket trading bot” category people search for: Polymarket BTC 5 minute, Polymarket BTC 15 minute, and Polymarket CLOB trading bot TypeScript.

Who this is for

• Developers building or extending a Polymarket CLOB trading bot in TypeScript.
• Traders experimenting with short-duration Up/Down markets (e.g. 5m / 15m) on Polymarket with small size and strict risk controls.
• Anyone evaluating arbitrage-adjacent or rule-based automation on Polymarket prediction markets (not only directional “picks”).

How it differs from “classic” two-window arbitrage

Many guides describe cross-window ideas (e.g. comparing 5-minute and 15-minute BTC markets at once, synchronized endTime, paired legs). This repo instead:

• Trades one window per running config (market_period = 5, 15, 60, etc.).
• Uses transparent trade.toml thresholds (ratios, ranges) rather than a hard-coded dual-leg arbitrage engine.

You can run two processes with two configs (e.g. one market_period = "5", one "15") as a future operational pattern; that is not bundled as a single orchestrated binary here.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    index.ts (bootstrap + banner)                 │
│  CLOB L1 → derive/create API key → CLOB L2 client               │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│  Market loop (per window slug)                                   │
│  • Gamma: resolve market + token IDs                             │
│  • Prices: poll quotes for UP / DOWN                             │
│  • Trade.updatePrices → make_trading_decision                    │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│  Strategy (trade_1 | trade_2)              trade/decision.ts    │
│  • Entry gates, exits, optional emergency swap                   │
└────────────────────────────┬────────────────────────────────────┘
                             │
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│  Orders + balances                     trade/trade.ts             │
│  • createAndPostMarketOrder (FAK)                                │
│  • Retry policy (utils/retry.ts) + trading errors (human text)   │
└─────────────────────────────────────────────────────────────────┘

Key modules

Quick start

Prerequisites

• Node.js ≥ 20.6
• Polygon wallet with Polymarket-compatible setup (private key + funder / proxy deposit address as required by your account type)
• Small USDC balance appropriate for trade_usd experiments

1. Clone and install

git https://github.com/lorine93s/openclaw-polymarket-ai-arbitrage-trading-bot
cd openclaw-polymarket-ai-arbitrage-trading-bot
npm install

2. Environment

Copy .env.example to .env and fill in secrets (never commit .env).
The bot validates required env values on startup and will show a clear warning if your private key or funder address is missing/invalid.

3. Strategy and market

Edit trade.toml:

• Set [market].market_period to "5" or "15" for Polymarket 5 minute or 15 minute BTC (or other coin) windows.
• Choose strategy = trade_1 or trade_2.
• Set trade_usd, max_retries, entry_buy_cooldown_sec.

4. Run

# Development
npm run dev

# Production-style
npm run build
npm start

Environment variables

See .env.example for commented templates.

Related queries: Polymarket API credentials, Polymarket CLOB wallet setup, Polymarket trading bot environment variables, Polymarket private key invalid byteslike.

trade.toml reference

To emphasize Polymarket BTC 5 minute vs Polymarket BTC 15 minute, change only market_period (and optionally market_coin).

OpenClaw-style AI decision layer

This repo includes an optional OpenClaw-style decision module designed to be pluggable, testable, and operator-explainable.
It is not a generic ML framework and it does not promise “risk-free arbitrage”.

• Default behavior preserved: If [openclaw].enabled = false, the bot behaves exactly as before using trade_1 / trade_2.
• What it consumes: current UP/DOWN quotes, a small in-memory lookback window of recent quotes, time-to-expiry, position state, and thresholds from trade.toml.
• What it produces: high-level actions like BUY_UP, BUY_DOWN, CLOSE_POSITION, HOLD with a reason string (logged in the console).
• Safety gates: the signal is still subject to existing bot risk controls (cooldowns, hasBought, retries, etc.). If an action isn’t allowed, the bot simply won’t place the order.

Config block in trade.toml:

[openclaw]
enabled = true
mode = "deterministic" # or "http"
min_edge_bps = 50
max_spread_bps = 200
lookback_points = 12

# Optional: OpenClaw HTTP/LLM integration (mode="http")
# [openclaw.http]
# url = "https://your-openclaw-service.example.com/decide"
# bearer_token = "optional"
# timeout_ms = 2500

Operations and risk management

• Start with low trade_usd and verify fills, balances, and logs.
• Execution risk remains: partial fills, API errors, and fast-moving 5m / 15m books can move against you between signal and fill.
• entry_buy_cooldown_sec reduces tight loops when a failure is not transient (e.g. credential / signing issues).
• Prefer a dedicated wallet and balance you can afford to lose.

Troubleshooting

Safety and compliance

• This software places real orders when configured with live keys and a funded account.
• No warranty. Past or hypothetical arbitrage edges do not guarantee future results.
• Comply with local laws, Polymarket Terms of Service, and eligibility rules in your jurisdiction.
• Never commit private keys or paste them into support chats.

FAQ

Is this a “risk-free Polymarket arbitrage bot”?
No automated strategy is risk-free. This project automates rules and execution; slippage, failed legs, and operational bugs can lose money.

Is this specifically a Polymarket BTC 5 minute market bot?
You configure market_period = "5" (and market_coin = "btc") for that use case. The same code path supports 15m and other periods.

Does it run Polymarket WebSocket feeds?
The core loop described here uses polling for prices; dependencies may include WS-oriented packages for future extension — check src/ for actual usage.

Can I use it for ETH / SOL Polymarket markets?
Yes — set market_coin in trade.toml.

Keywords

Common search terms this repo targets:

polymarket trading bot, polymarket arbitrage bot, polymarket btc trading bot, polymarket btc arbitrage bot, polymarket clob bot, polymarket clob trading bot, polymarket orderbook bot, @polymarket/clob-client-v2, polymarket api key, polymarket market making bot, polymarket up down bot, polymarket 5 minute bot, polymarket 5m btc, polymarket 15 minute bot, polymarket 15m btc, polymarket typescript bot, polymarket nodejs bot, prediction market trading bot, crypto prediction market bot, openclaw prediction market bot, openclaw polymarket trading bot, openclaw ai prediction market bot, openclaw prediction market bot,

License

ISC — see package.json. Use at your own risk.