Skip to main content
skill CX Codex

polymarket-paper-trader — Claude Code skill: install and usage

polymarket-paper-trader simulates Polymarket prediction market trading using live order books without using real funds.

no license 208 installs ★ 100 updated 2026-02-26

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a claude-code
Open on GitHub

What polymarket-paper-trader does

This skill provides a local engine for simulated trading on prediction markets. Instead of relying on midpoint values, market buy orders walk the actual order book from clob.polymarket.com to compute fills. All virtual balances and transaction logs remain saved between runs inside an SQLite database at ~/.polymarket-paper/portfolio.db.

A built-in guard monitors drawdowns and position exposure. It enforces constraints such as a 10% maximum stake per bet and a 5% daily loss cutoff, which require the --force flag to override.

The tool relies on local Python and network reachability to Polymarket endpoints. Trading calls require specific market token identifiers, which you query from the Gamma API or feed in via JSON payload to execute_paper.py.

What it helps with

  • test market prediction tactics against live order books without financial loss
  • maintain a persistent demo portfolio in a local SQLite database
  • enforce systematic drawdown limits and maximum position sizes
  • generate structured performance and position summary reports

Example prompts for the agent

  • Initialize a paper trading portfolio with a 1000 balance
  • Simulate buying 50 dollars worth of YES shares for token TOKEN_ID
  • Run the health check script to evaluate drawdowns and risk limits

How to install polymarket-paper-trader

1Skills CLI (Vercel)

npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a claude-code

2Manually: put the files in place

~/.claude/skills/polymarket-paper-trader/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/polymarket-paper-trader/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about polymarket-paper-trader

How to install polymarket-paper-trader in Claude Code?

Run npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a claude-code in your terminal.

Do I need a funded crypto wallet or API keys?

No wallet, private keys, or actual capital are needed. The engine reads public market books and tracks simulated balances locally.

Where does the skill keep transaction history?

Your holdings and execution log are recorded in an SQLite database file at ~/.polymarket-paper/portfolio.db.

Similar skills

All skills for Finance and business →

From the same set6

Project sponsors

Companies that keep this analytics open