Prediction Trade Journal

Auto-log trades with context, track outcomes, generate calibration reports to improve trading.

Security Scan

The skill's code, instructions, and requested environment access are coherent with a trade-journal that reads a Simmer API and stores data locally — nothing indicates obvious misdirection or secret exfiltration, but there are a few small mismatches you should note before installing.

Purpose & Capability

Name/description claim to sync trades, track outcomes, and report — the code implements API calls to https://api.simmer.markets, local storage under data/, CLI entrypoints, and a log_trade() helper for other skills. The declared pip dependency (simmer-sdk) and required API key are appropriate for this purpose.

Instruction Scope

SKILL.md instructs installing simmer-sdk, setting SIMMER_API_KEY, and running the provided CLI. The runtime instructions and the code operate only on the Simmer API and local files (data/trades.json, data/context.json). Note: the skill exposes a programmatic log_trade() function for other skills to call, which is expected for enrichment but means other installed skills could add context to your stored trades.

Install Mechanism

There is no arbitrary download/install step. The manifest lists a pip dependency (simmer-sdk), which is a standard package-install mechanism. No external URLs, archives, or non-standard installs are present.

Credentials

The skill requires a single API credential (SIMMER_API_KEY) which matches its function. However, the code also reads additional environment variables (SIMMER_API_URL, SIMMER_JOURNAL_FETCH_LIMIT, SIMMER_JOURNAL_AUTO_SYNC) not listed in SKILL.md or clawhub.json — this is a minor mismatch you should be aware of but not inherently malicious.

Persistence & Privilege

The skill stores data under its own directory (data/), does not request always:true, and does not modify other skills or global agent settings. It does perform local file writes (trades and context files), which is expected for a journal.

Assessment

This skill appears to do what it says: it needs your Simmer API key so it can fetch your trades and stores them locally under the skill folder (data/trades.json and data/context.json). Before installing: (1) confirm you trust simmer.markets and the simmer-sdk package; (2) be comfortable that the SIMMER_API_KEY grants read access to your trades; (3) note the code also accepts optional env vars (SIMMER_API_URL, SIMMER_JOURNAL_FETCH_LIMIT, SIMMER_JOURNAL_AUTO_SYNC) — review or set those if you need different behavior; (4) review the included Python files if you want to verify how errors and API responses are handled; and (5) consider storing the API key in a secure place and rotating it if you stop using the skill. If you need higher assurance, ask the author for a verified homepage or repository and verify the simmer-sdk package source.

Track every trade, learn from outcomes, improve your edge.

When to Use This Skill

Use this skill when the user wants to:

• See their trade history
• Track win rate and P&L
• Generate trading reports
• Analyze which strategies work best

Setup Flow

When user asks to install or configure this skill:

1. Install the Simmer SDK

   pip install simmer-sdk
   

2. Ask for Simmer API key

   • They can get it from simmer.markets/dashboard → SDK tab
   • Store in environment as SIMMER_API_KEY

Quick Commands

# Sync trades from API
python tradejournal.py --sync

# Show recent trades
python tradejournal.py --history 10

# Generate weekly report
python tradejournal.py --report weekly

# Export to CSV
python tradejournal.py --export trades.csv

API Reference:

• Base URL: https://api.simmer.markets
• Auth: Authorization: Bearer $SIMMER_API_KEY
• Trades: GET /api/sdk/trades

How It Works

1. Sync - Polls /api/sdk/trades to fetch trade history
2. Store - Saves trades locally with outcome tracking
3. Track - Updates outcomes when markets resolve
4. Report - Generates win rate, P&L, and calibration analysis

CLI Reference

Command	Description
--sync	Fetch new trades from API
--history N	Show last N trades (default: 10)
--sync-outcomes	Update resolved markets
--report daily/weekly/monthly	Generate summary report
--config	Show configuration
--export FILE.csv	Export to CSV
--dry-run	Preview without making changes

Configuration

Setting	Environment Variable	Default
API Key	SIMMER_API_KEY	(required)

Storage

Trades are stored locally in data/trades.json:

{
  "trades": [{
    "id": "uuid",
    "market_question": "Will X happen?",
    "side": "yes",
    "shares": 10.5,
    "cost": 6.83,
    "outcome": {
      "resolved": false,
      "winning_side": null,
      "pnl_usd": null
    }
  }],
  "metadata": {
    "last_sync": "2025-01-29T...",
    "total_trades": 50
  }
}

Skill Integration

Other skills can enrich trades with context:

from tradejournal import log_trade

# After executing a trade
log_trade(
    trade_id=result['trade_id'],
    source="copytrading",
    thesis="Mirroring whale 0x123...",
    confidence=0.70
)

This adds thesis, confidence, and source to the trade record for better analysis.

Example Report

📓 Weekly Report
========================================
Period: Last 7 days
Trades: 15
Total cost: $125.50
Resolved: 8 / 15
Win rate: 62.5%
P&L: +$18.30

By side: 10 YES, 5 NO

Troubleshooting

"SIMMER_API_KEY environment variable not set"

• Set your API key: export SIMMER_API_KEY=sk_live_...

"No trades recorded yet"

• Run python tradejournal.py --sync to fetch trades from API

Trades not showing outcomes

• Run python tradejournal.py --sync-outcomes to update resolved markets