trade-history

What This Skill Does

The trade-history skill for OpenClaw provides a reliable interface for managing and reviewing your local trading logs. By interacting directly with the trades.jsonl log file stored in your workspace, the agent can retrieve, filter, and present your historical trading activity. This skill acts as a bridge between raw data storage and human-readable reporting, allowing you to query specific symbols or limit results to recent timeframes. It ensures that your trading data—consisting of entries, stop-losses, take-profits, and custom notes—is always accessible during your decision-making processes. The tool is strictly read-only, ensuring that your precious trading records remain immutable and safe from accidental corruption.

Installation

You can integrate this skill into your OpenClaw environment by running the following command in your terminal: clawhub install openclaw/skills/skills/newbienodes/trade-history This command pulls the necessary Python scripts from the official repository and configures the execution path for your agent.

Use Cases

This skill is perfect for traders who maintain a local ledger of their market positions. Use it when you need to perform a rapid performance review, check your recent trade entries to verify your strategy execution, or analyze your past signals. It is particularly useful for traders who operate multiple strategies and need to isolate data based on asset pairs like BTCUSDT or ETHUSDT. It effectively turns your raw JSONL logs into a high-level performance tracking dashboard.

Example Prompts

1. "Tampilkan 5 trade terakhir di BTCUSDT untuk evaluasi performa."
2. "Ada berapa trade yang sudah tersimpan di log saya sejauh ini?"
3. "Berikan recap trade terakhir yang saya catat."

Tips & Limitations

• Ordering: The script is hardcoded to return results in reverse chronological order, meaning your most recent trades will always appear at the top.
• Data Integrity: Because the tool only reads the log file, it cannot modify your data. Always ensure your logging mechanism is functioning correctly externally.
• Empty States: If you haven't performed any trades yet or the file is missing, the skill will return an empty list gracefully, meaning your agent will simply inform you that no records were found rather than throwing an error or crashing.