polymarket-paper-trader

Automate paper-money Polymarket trading with a CLI workflow and local SQLite storage.

372|52|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/agent-next/polymarket-paper-trader --skill polymarket-paper-trader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket-paper-trader
Source: https://github.com/agent-next/polymarket-paper-trader/tree/main/skill/polymarket-paper-trader
Command: npx skills add https://github.com/agent-next/polymarket-paper-trader --skill polymarket-paper-trader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Autonomous AI agents often struggle to safely test and optimize trading strategies on live markets without risking real funds. This Skill enables paper trading against Polymarket’s real order books in a sandboxed environment, delivering a realistic testing ground and a public leaderboard track record.

Core Features & Use Cases

  • End-to-end trading flow: init_account, list_markets/search_markets, buy/sell, portfolio, stats, and sharing outputs.
  • Paper-trading with real order books: simulate trades against live liquidity with accurate fees and slippage.
  • Backtesting and performance sharing: replay strategies against historical data and publish a stats_card for visibility.

Quick Start

Initialize the agent with a paper balance and begin by scouting markets and placing a few trades to see how the system operates.

Frequently Asked Questions about polymarket-paper-trader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test an AI trading agent against Polymarket without risking real money?

Paper trading on Polymarket lets you simulate trades against live order books using virtual funds. This Skill provides a sandboxed environment with a $10k paper balance so agents can execute trades autonomously without real credentials.

Can I backtest trading strategies using Polymarket's historical order book data?

Backtesting Polymarket strategies is supported by replaying trades against historical data. This Skill includes a backtesting capability that allows you to evaluate autonomous trading strategies and generate performance metrics for optimization.

How do I track portfolio performance and share results for an autonomous trading agent?

Portfolio tracking and performance sharing are handled through a stats command and shareable stats_card. The Skill isolates data in a local SQLite store and generates shareable outputs so you can publish results to a public leaderboard for visibility.

Does Polymarket paper trading require API credentials or a funded account?

Polymarket paper trading with this Skill requires no real money or credentials. It operates autonomously in a sandboxed environment using a local SQLite store, simulating trades against real liquidity with accurate fees and slippage.

What's the best way to build an end-to-end automated trading workflow for prediction markets?

An end-to-end automated trading workflow for prediction markets is built using a CLI-driven process. This Skill automates the full flow from account initialization and market discovery to buying, selling, risk management, and performance reporting.

What are the limitations of paper trading on Polymarket with a local SQLite database?

Paper trading limitations include dependency on local SQLite for data isolation, meaning state is not cloud-synced. While it simulates fees and slippage against live order books, execution is simulated and does not interact with real market liquidity.