Skip to content

Polymarket Paper Trader

Paper trading simulator for Polymarket

Install

$npx clawhub install polymarket-paper-trader
Claude Code
claude mcp add polymarket-paper-trader -- npx clawhub install polymarket-paper-trader
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "npx",
      "args": [
        "clawhub",
        "install",
        "polymarket-paper-trader"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

polymarket-paper-trader

A zero-risk gym for AI agents on real prediction markets — real order books, official fees, verified fill fidelity. Practice, evaluate, and benchmark decision intelligence.

Agents make probability judgments all day. Polymarket is the world's largest prediction market, and its order books are the honest scoreboard: real money, real prices, real outcomes. But you cannot hand an agent a wallet to learn with. So this project gives every agent what SWE-bench gave coders — a faithful environment where judgment has consequences and gets scored:

  • Practice — your agent trades $10k of paper money against live Polymarket order books, with the same fee model and fill mechanics as the real exchange
  • Evaluate — the polymarket-benchmark harness in this repository (installed separately) scores any model on prediction-market decision sets (Brier score, calibration, alpha)
  • Compare — multi-account battles and leaderboards rank agents against each other
  • Compete — Forecast Arena: the live public leaderboard where AI models and simple baselines forecast the same Polymarket questions daily and are scored by real outcomes (Brier score). Runs from this repo (enter your model · workflow · raw data).

Part of agent-next — building an agentic world.

60-second demo

pip install polymarket-paper-trader
pm-trader init --balance 10000                 # $10k paper money
pm-trader markets search "bitcoin"             # find markets
pm-trader buy will-bitcoin-hit-100k yes 500    # buy $500 of YES
pm-trader stats --card                         # shareable stats card

Prefer not to install? uvx --from polymarket-paper-trader pm-trader-mcp runs the MCP server your agent connects to (see Works with below).

That's it. Your AI agent is now trading Polymarket with zero risk.

Install

# via pip (CLI + MCP server)
pip install polymarket-paper-trader

# or the MCP server alone, with no install
uvx --from polymarket-paper-trader pm-trader-mcp

# from source (development)
uv pip install -e ".[dev]"

Requires Python 3.10+.

Works with

Runtime One-line install
Claude Code /plugin marketplace add agent-next/polymarket-paper-trader
Codex CLI codex mcp add polymarket-paper-trader -- uvx --from polymarket-paper-trader pm-trader-mcp
Cursor Add to Cursor
Gemini CLI gemini extensions install https://github.com/agent-next/polymarket-paper-trader
OpenCode / Goose / Cline / Windsurf / Copilot add pm-trader-mcp to the client's MCP config
OpenClaw / ClawHub npx clawhub install polymarket-paper-trader
Hermes Agent / LangChain / OpenAI Agents SDK / CrewAI wrap uvx --from polymarket-paper-trader pm-trader-mcp
ChatGPT / Claude.ai (remote MCP) add the remote /mcp URL in the host's remote-MCP settings

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

Explore related