Prediction Trade Journal — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

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

开发与 DevOps

作者：AD88 @adlai88

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.1.11

统计：⭐ 0 · 1.1k · 8 current installs · 8 all-time installs

⭐ 0

安装量（当前） 8

🛡 VirusTotal ：可疑 · OpenClaw ：良性

Package：adlai88/prediction-trade-journal

安全扫描（ClawHub）

VirusTotal ：可疑
OpenClaw ：良性

OpenClaw 评估

The skill's code, instructions, and required environment variables are consistent with its stated purpose (syncing and journaling trades); nothing in the bundle indicates hidden or unrelated access requests.

目的

Name/description (trade journaling, reporting) match the included code and CLI behavior: it polls a Simmer API, stores trades locally, updates outcomes, and generates reports. The only minor mismatch is that clawhub.json lists a pip dependency (simmer-sdk) but the shipped code uses direct HTTP requests rather than importing that SDK; this appears unnecessary but not malicious.

说明范围

SKILL.md instructions map to concrete operations in tradejournal.py: calling the API, writing to data/trades.json and data/context.json, and producing reports. The skill accesses network endpoints under api.simmer.markets and environment variables for configuration; it does not reference unrelated system paths or other credentials. The code will persist local files (trades/context/config) as expected for the feature.

安装机制

There is no install script (instruction-only deployment), which is lowest risk. However, clawhub.json declares a pip dependency (simmer-sdk) even though the included code uses urllib and doesn't import that package — this is an incongruity worth noting (may be vestigial or intended for optional features). No downloads from untrusted URLs or archives are present.

证书

The declared required credential (SIMMER_API_KEY) is appropriate and required for the described API access. Additional env vars used by the code (SIMMER_API_URL, SIMMER_JOURNAL_FETCH_LIMIT, SIMMER_JOURNAL_AUTO_SYNC) are reasonable configuration knobs but are not listed in clawhub.json or documented fully in SKILL.md, which is a minor documentation gap. No unrelated secrets or multiple external credentials are requested.

持久

The skill does not request always:true and will not auto-enable itself. It stores data under its own data/ directory and updates a local config.json if present; it does not modify other skills or system-wide agent settings.

综合结论

This skill appears to do what it says: it will send requests to api.simmer.markets using SIMMER_API_KEY and store trade data locally in the skill folder (data/trades.json and data/context.json). Before installing: (1) ensure the SIMMER_API_KEY you provide has least-privilege/scoped access and that you trust api.simmer.markets; (2) run the skill in an isolated environment (or container) if you want to limit lateral access to local files; (3) no…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Prediction Trade Journal」。简介：Auto-log trades with context, track outcomes, generate calibration reports to i…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/adlai88/prediction-trade-journal/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
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

## Quick Commands

```bash
# 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`:

```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:

```python
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