← Back to Skills Marketplace
494
Downloads
1
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install paper-trader
Description
Run a structured paper-trading loop with SQLite-backed event logging, position tracking, and PnL review. Use when opening/closing simulated trades, journalin...
Usage Guidance
This skill appears coherent and low-risk: it runs a local Node script and stores an append-only SQLite DB under ~/.openclaw. Before installing or running: (1) review the full script if you want to be certain there is no hidden network behavior (the visible code shows no network calls), (2) be aware it will create/write the DB file in your home directory—move or back it up if needed, and (3) run the included test suite in an isolated/temp directory if you want to validate behavior before using real data. No cloud keys or other secrets are required by the skill.
Capability Analysis
Type: OpenClaw Skill
Name: paper-trader
Version: 1.0.1
The paper-trader skill bundle is a legitimate utility for tracking simulated trades using a local SQLite database. The code in scripts/paper_trading.ts implements standard trading journal logic (PnL calculation, risk management, and event logging) using built-in Node.js modules like node:sqlite and node:crypto, with no external dependencies or network activity. The SKILL.md instructions are well-aligned with the script's functionality and do not contain any malicious prompt injection attempts.
Capability Assessment
Purpose & Capability
Name/description (paper trading, event logging, PnL) match the included code and CLI instructions. The only required binary is node, which is appropriate for a TypeScript/Node CLI. The DB path (~/.openclaw/paper-trading.db) and the operations on it are expected for this functionality; there are no unrelated credentials, cloud APIs, or system-level accesses requested.
Instruction Scope
SKILL.md instructs the agent/user to run the included Node script, use an append-only SQLite DB, and provides explicit commands (init, snapshot, open, close, etc.). The instructions reference only the included script, a local DB path, and an explicit snapshot source 'dexscreener' (which the code validates). The provided source does not contain network-fetching imports or calls in the visible code, and the CLI requires prices to be passed for snapshots in tests—there is no evidence the skill autonomously contacts external endpoints or exfiltrates data.
Install Mechanism
There is no install spec; the skill is instruction-only with code files bundled. Nothing is downloaded from external URLs and no archives are extracted. Risk is low because no arbitrary remote install step is present.
Credentials
The skill requests no environment variables or credentials. It stores its data in a user-local SQLite DB (~/.openclaw) which is proportional to a paper-trading tool. No access to unrelated secrets or config paths is requested.
Persistence & Privilege
always is false and the skill does not request permanent platform-level presence. It creates and writes its own DB under the user's home directory, which is appropriate for its purpose and does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install paper-trader - After installation, invoke the skill by name or use
/paper-trader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Tightened requirements: `mint` is now REQUIRED for `snapshot` and `open` commands.
- Updated instructions for DEX tokens: use wrapped token addresses (e.g., WETH, WBTC).
- Specified that `--source dexscreener` should be used for snapshots.
- Clarified workflow step to always provide `--mint` and `--source dexscreener` when logging snapshots.
- Improved documentation for asset identity, especially for DEX trading.
v1.0.0
Initial release of paper-trading skill.
- Provides a structured paper trading loop with SQLite-backed event logging and immutable recordkeeping.
- Supports position tracking, PnL review (realized and unrealized), and detailed thesis journaling.
- Command-line interface for opening/closing simulated trades, adjusting stops/takes, tracking portfolio, and automating weekly performance summaries.
- Events are append-only; PnL computed by event replay for robust auditability.
- No npm or external dependency required for SQLite backend.
Metadata
Frequently Asked Questions
What is Paper Trader?
Run a structured paper-trading loop with SQLite-backed event logging, position tracking, and PnL review. Use when opening/closing simulated trades, journalin... It is an AI Agent Skill for Claude Code / OpenClaw, with 494 downloads so far.
How do I install Paper Trader?
Run "/install paper-trader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Paper Trader free?
Yes, Paper Trader is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Paper Trader support?
Paper Trader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Paper Trader?
It is built and maintained by Ben (@brs999); the current version is v1.0.1.
More Skills