Prediction Trade Journal

该 Skill 用 Python CLI 从 Simmer 预测市场 API 同步交易记录并本地保存，跟踪市场结算结果，统计胜率、盈亏并按日/周/月生成报告与校准分析，支持导出 CSV；其他 Skill 可通过 log_trade 补充论点、信心与来源，需要 SIMMER_API_KEY。

adlai88

热度 91.57

最近更新 2026-05-20 14:01:42

分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：财务 / 报告撰写 / 数据处理 / 市场分析

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add prediction-trade-journal

Metadata

name: prediction-trade-journal
description: Auto-log trades with context, track outcomes, generate calibration reports to improve trading.
metadata: {"author":"Simmer (@simmer_markets)","version":"1.1.8","displayName":"Prediction Trade Journal","difficulty":"beginner"}

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

Setup Flow

When user asks to install or configure this skill:

Install the Simmer SDK
```
pip install simmer-sdk
```
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

Sync - Polls /api/sdk/trades to fetch trade history
Store - Saves trades locally with outcome tracking
Track - Updates outcomes when markets resolve
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