Trade History

Read and display recorded trade events from the local trades.jsonl log file, with optional filtering by symbol and configurable limit.

When to Use

User asks: "tampilkan trade history"
User asks: "trade apa saja yang sudah dicatat?"
User asks: "recap trade BTC terakhir"
User asks: "lihat 10 trade terakhir"
User asks: "ada berapa trade yang tersimpan?"

How It Works

This skill runs a local Python script that:

Reads the local trades.jsonl file line by line.
Parses each line as a JSON object.
Filters by symbol if specified.
Sorts results newest first (reverse chronological).
Returns up to N records (default 20).
Returns a JSON object with count and items array.

Workflow

Step 1 — Run the read script via bash tool: python3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py

Step 2 — Parse the JSON output (count + items array).

Step 3 — Present the trade list to the user in a readable format:

Show each trade: symbol, side, entry, sl, tp, note, timestamp
Mention total count
Newest trades first

Optional Arguments

Run with JSON args to filter or limit results: python3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-history/read.py '{"limit": 10, "symbol": "BTCUSDT"}'

Supported args:

limit: number of trades to return (default 20)
symbol: filter by trading pair (e.g. BTCUSDT)

Output Format

{ "count": 3, "items": [ { "symbol": "BTCUSDT", "side": "BUY", "entry": 94500, "sl": 94000, "tp": 95500, "note": "sweep+fvg signal", "source": "btc-analyzer", "ts": "2026-02-23T00:00:00Z" } ] }

Log File Location

/home/windows_11/.openclaw/polymarket-workspace/trades.jsonl

Error Handling

If log file does not exist yet: {"count": 0, "items": []}

No error is thrown — returns empty result gracefully.

Guardrails

Always run the script — never fabricate trade history.
If file is missing, return empty list gracefully without error.
Output must be JSON only from the script.
Always display newest trades first (reverse chronological order).
Never delete or modify the log file — read only.