Paper Trading

Simulates stock and crypto trading with virtual currency and persistent JSON state.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/datagridSolution/forex-trading-ai-agent --skill paper-trading-datagridsolution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Paper Trading
Source: https://github.com/datagridSolution/forex-trading-ai-agent/tree/main/skills/paper-trading
Command: npx skills add https://github.com/datagridSolution/forex-trading-ai-agent --skill paper-trading-datagridsolution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Paper Trading lets you test trading strategies and execution logic without risking real money while still using realistic trade mechanics and market-like price variation.

Core Features & Use Cases

  • Virtual Balance & Persistent State: Start with configurable paper funds and keep account state saved to a JSON file between runs.
  • Simulated Execution & Order Types: Support market, limit, and risk controls such as stop-loss and take-profit for strategy validation.
  • Performance Tracking: Track realized/unrealized P&L, trade history, fee impact, and portfolio summaries to evaluate outcomes.
  • Use Case: Validate a new entry/exit strategy (e.g., limit-buy then sell with stop-loss/take-profit) over many simulated trades to compare performance before going live.

Quick Start

Initialize a paper account with an initial balance by running: "python paper_trading.py init --balance 10000 --currency USD".

Frequently Asked Questions about Paper Trading

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

FAQPage Schema
How do I test trading strategies without risking real money?

Paper trading lets you test trading strategies risk-free by simulating forex and crypto execution with a virtual balance. You can run repeated buy and sell actions using market, limit, stop-loss, and take-profit orders to validate performance before going live.

How do I simulate limit and stop-loss orders for a trading strategy?

You can simulate limit and stop-loss orders by placing CLI-driven commands that enforce balance and position validation. The simulation supports market, limit, stop-loss, and take-profit order types to validate entry and exit logic against market-like price variations.

Can I track unrealized and realized P&L for a virtual portfolio over time?

Yes, you can track realized and unrealized P&L over time. The simulation tracks trade history, fee impact, and portfolio summaries, allowing you to evaluate performance outcomes across repeated simulated trades.

Does paper trading keep my account balance and portfolio state saved between runs?

Yes, paper trading keeps your account balance and portfolio state saved. It initializes a configurable virtual account and persists the state to a JSON file, maintaining your portfolio data and balance between separate runs.

What's the best way to compare a new entry and exit strategy before going live?

The best way to compare entry and exit strategies is using a paper trading simulation. You can execute limit-buy then sell with stop-loss and take-profit controls over many simulated trades, then evaluate the realized and unrealized performance outcomes.

Do I need any specific dependencies or broker API to run a paper trading simulation?

No specific dependencies or broker APIs are required to run a paper trading simulation. It operates independently using a CLI-driven Python script to initialize accounts and place orders while enforcing balance and position validation locally.