Skill: Prediction Trade Journal

Owner: adlai88

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

Tags: latest:1.1.10

Version history:

v1.1.10 | 2026-02-27T10:22:47.697Z | auto

• Added a "difficulty: beginner" field to SKILL.md for clearer guidance.
• No functional or command changes; documentation improvement only.

v1.1.9 | 2026-02-27T03:59:32.149Z | user

Sync

v1.1.8 | 2026-02-25T13:56:12.834Z | auto

No changes detected in this version.

• Version number remains the same: 1.1.7
• No file or documentation updates
• No new features or bug fixes added

v1.1.7 | 2026-02-25T13:49:32.127Z | auto

• Added simmer-sdk as a required package in metadata for installation.
• Updated version number to 1.1.7 in the documentation.

v1.1.6 | 2026-02-24T13:44:13.596Z | auto

• Updated version number to 1.1.5 in documentation.
• No functional changes; SKILL.md file version metadata was incremented for consistency.

v1.1.5 | 2026-02-17T07:53:44.380Z | auto

• Updated documentation to remove the API URL configuration option and default; API key is now the only documented required environment variable.
• Bumped version from 1.1.3 to 1.1.4 in SKILL.md.

v1.1.4 | 2026-02-17T07:00:27.516Z | auto

• Updated version number from 1.1.2 to 1.1.3 in SKILL.md.
• No other functional or documentation changes.

v1.1.3 | 2026-02-17T06:36:19.188Z | auto

• Removed the local sample data file data/trades.json.
• No user-facing functionality or documentation changes.

v1.1.2 | 2026-02-14T14:59:29.296Z | auto

• Improved documentation with clear usage instructions, command reference, and integration examples.
• Detailed description of features: auto-logging trades, tracking outcomes, and generating calibration reports.
• Added explicit CLI command documentation and example JSON data structure.
• Provided troubleshooting tips for common setup issues.
• Listed environment variables and configuration requirements.

Archive index:

Archive v1.1.10: 4 files, 8763 bytes

Files: scripts/status.py (477b), SKILL.md (3179b), tradejournal.py (21822b), _meta.json (144b)

File v1.1.10:SKILL.md

---

name: prediction-trade-journal displayName: Prediction Trade Journal description: Auto-log trades with context, track outcomes, generate calibration reports to improve trading. metadata: {"clawdbot":{"emoji":"📓","requires":{"env":["SIMMER_API_KEY"],"pip":["simmer-sdk"]},"cron":null,"autostart":false}} authors:

• Simmer (@simmer_markets) version: "1.1.8" difficulty: beginner published: true

---

Prediction Trade Journal

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

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

File v1.1.10:_meta.json

{ "ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x", "slug": "prediction-trade-journal", "version": "1.1.10", "publishedAt": 1772187767697 }

Archive v1.1.9: 4 files, 8749 bytes

Files: scripts/status.py (477b), SKILL.md (3158b), tradejournal.py (21822b), _meta.json (143b)

File v1.1.9:SKILL.md

---

name: prediction-trade-journal displayName: Prediction Trade Journal description: Auto-log trades with context, track outcomes, generate calibration reports to improve trading. metadata: {"clawdbot":{"emoji":"📓","requires":{"env":["SIMMER_API_KEY"],"pip":["simmer-sdk"]},"cron":null,"autostart":false}} authors:

• Simmer (@simmer_markets) version: "1.1.8" published: true

---

Prediction Trade Journal

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

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

File v1.1.9:_meta.json

{ "ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x", "slug": "prediction-trade-journal", "version": "1.1.9", "publishedAt": 1772164772149 }