Trade Memory

---

name: trade-memory version: 1.0.0 description: Save a trade or signal event to local memory log file (trades.jsonl). Use when a trade signal is confirmed and needs to be recorded, saved, or logged for future reference and history tracking. metadata: { "openclaw": { "emoji": "🧠", "requires": { "bins": ["python3"] }, }, }

---

Trade Memory

Append confirmed trade signals or executed trades to a local JSONL log file for persistent memory and history tracking.

When to Use

User says: "simpan trade ini"

User says: "catat sinyal BTC tadi"

User says: "log trade BUY BTC entry 94500"

Agent wants to record a signal after btc-analyzer returns a result

User says: "tambahkan ke trade history"

How It Works

This skill runs a local Python script that: 1. Accepts a JSON object as input (symbol, side, entry, sl, tp, note, source, ts). 2. Validates the input is proper JSON. 3. Appends the trade as a single line to trades.jsonl (creates file and directory if not exists). 4. Returns a JSON confirmation object.

Workflow

Step 1 — Collect trade data from user or agent:

symbol: trading pair (e.g. BTCUSDT)

side: BUY or SELL

entry: entry price (number)

sl: stop loss price (number)

tp: take profit price (number)

note: optional description or reason

source: origin of signal (e.g. btc-analyzer, manual, telegram)

ts: ISO timestamp (auto-filled if not provided)

Step 2 — Run the save script via bash tool: python3 ~/.npm-global/lib/node_modules/openclaw/skills/trade-memory/save.py ''

Step 3 — Confirm to user that trade was saved successfully.

Input Format

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

Output Format

{"ok": true, "path": "/home/windows_11/.openclaw/polymarket-workspace/trades.jsonl", "appended": 1, "trade": {...}}

Log File Location

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

Each line is one JSON object representing one trade event.

Error Handling

If input is not valid JSON: {"ok": false, "error": "Invalid JSON: "}

Guardrails

Always APPEND to the file, never overwrite existing trades.

Create directory and file automatically if they do not exist.

Always run the script — never simulate or fake a save confirmation.

Timestamp (ts) is auto-generated in UTC if not provided by user.

Output must be JSON only.