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
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/polymarket-paper-trader/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/polymarket-paper-trader/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a codex2Manually: put the files in place
.agents/skills/polymarket-paper-trader/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a cursor2Manually: put the files in place
.cursor/skills/polymarket-paper-trader/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mjunaidca/polymarket-skills polymarket-paper-trader2Manually: put the files in place
.github/skills/polymarket-paper-trader/SKILL.md1Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a gemini-cli2Platform CLI
gemini skills install https://github.com/mjunaidca/polymarket-skills --path polymarket-paper-traderManually: put the files in place
.devin/skills/polymarket-paper-trader/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.