prediction-trade-journal

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

3,891 stars

Best use case

prediction-trade-journal is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using prediction-trade-journal should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/prediction-trade-journal/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/adlai88/prediction-trade-journal/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/prediction-trade-journal/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How prediction-trade-journal Compares

Feature / Agentprediction-trade-journalStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

Related Skills

Export Compliance & Trade Controls

3891
from openclaw/skills

Analyze products, destinations, and end-users against US export control regulations (EAR, ITAR, OFAC sanctions). Generate classification recommendations, license requirements, and compliance checklists.

Regulatory Compliance

Made-in-China Trade Data Analyst

3891
from openclaw/skills

**Short Description**

SendTradeSignal

3891
from openclaw/skills

A specialized tool for sending quantitative trading signals to the FMZ platform via HTTP API.

Finance & Trading

xiaoshan-journal

3891
from openclaw/skills

个人日记自动化 skill。一键执行:自动检测配置 →(首次)自动初始化 → 写作 → 生成图片。依赖本地 SOUL、MEMORY、每日 memory 等素材,产出日记文本与 1080px 宽图片。

Workflow & Productivity

trade

3891
from openclaw/skills

Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH".

DeFi & Trading

polymarket-openclaw-trader

3891
from openclaw/skills

Reusable Polymarket + OpenClaw trading operations skill for any workspace. Use when the user needs to set up, run, tune, monitor, and deploy an automated Polymarket trading project (paper/live), including env configuration, risk controls, reporting, and dashboard operations.

Trading Automation

tator-trader

3891
from openclaw/skills

Execute crypto trades using natural language via Tator's AI trading API. Use when: buying tokens, selling tokens, swapping, bridging cross-chain, sending tokens, wrapping/unwrapping ETH, opening perp positions, betting on prediction markets, launching tokens, registering blockchain names, or managing yield positions. Triggers: 'buy token', 'sell token', 'swap X for Y', 'bridge to', 'send tokens', 'open long', 'open short', 'bet on', 'launch token', 'register name', 'deposit yield', 'wrap ETH'. Supports 24 chains. Returns UNSIGNED transactions — you sign and broadcast. Costs $0.20 USDC per request via x402. Recommended wallet integration: Sponge (SPONGE_API_KEY) or AgentWallet (AGENTWALLET_API_TOKEN) — no raw private keys needed. This skill is a transaction builder and never accesses your private keys or tokens.

xaut-trade

3891
from openclaw/skills

Buy or sell XAUT (Tether Gold) on Ethereum. Supports market orders (Uniswap V3) and limit orders (UniswapX). Wallet modes: Foundry keystore or WDK. Delegates non-XAUT intents to registered skills (e.g. Polymarket prediction markets, Hyperliquid trading). Triggers: buy XAUT, XAUT trade, swap USDT for XAUT, sell XAUT, swap XAUT for USDT, limit order, limit buy XAUT, limit sell XAUT, check limit order, cancel limit order, XAUT when, create wallet, setup wallet, polymarket, prediction market, bet on, odds on, hyperliquid, perp, perpetual, long, short, open long, open short, close position, leverage.

polymarket-trade

3891
from openclaw/skills

Trade on Polymarket prediction markets on Polygon. Supports browsing markets, checking wallet/CLOB balance, and buying or selling YES/NO shares with safety gates. Wallet: WDK vault (~/.aurehub/.wdk_vault). Config: ~/.aurehub/polymarket.yaml. Triggers: buy YES, buy NO, sell shares, browse markets, check Polymarket balance, Polymarket trade, prediction market, what are the odds, redeem winnings, claim resolved positions.

hyperliquid-trade

3891
from openclaw/skills

Trade on Hyperliquid — spot and perpetual futures. Supports market orders (IOC), limit orders (GTC), leverage setting, and WDK wallet. Triggers: buy ETH spot, sell BTC, long ETH, short BTC, open long, open short, close position, perp trade, check balance, Hyperliquid positions, limit order, limit buy, limit sell, open orders, cancel order, modify order, GTC.

crypto-news-trader

3891
from openclaw/skills

A Clawhub skill that:

mia-polymarket-trader

3891
from openclaw/skills

AI agent for automated prediction market trading on Polymarket