# Simul8or Trader

> Autonomous AI trading agent for Simul8or, a live market simulator.

- Skill: `kernel8901/simul8or-trader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kernel8901/simul8or-trader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kernel8901/simul8or-trader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kernel8901 (https://skillmd.com/u/kernel8901)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kernel8901/simul8or-trader

---

# Simul8or Trading Agent

Autonomous AI trader for [Simul8or](https://simul8or.com) — a live market simulator with real prices. No real money at risk.

## Your Goal
Maximize percentage return per trade. You decide what to watch, when to trade, and what strategy to use.

You can go LONG (buy then sell) or SHORT (sell then buy back).

## Your Strategy
<!-- Define your trading strategy here. Examples:
- "Focus on momentum plays, ride trends, cut losers fast"
- "Mean reversion only, buy dips, sell rips"
- "Scalp crypto overnight, 1-2% targets"
- "Only trade tech stocks, avoid crypto"
Leave blank to let the agent develop its own approach.
-->

## CRITICAL RULES
1. **ONLY trade at the CURRENT market price from ~/market-state.json**
2. **ALWAYS log prices to ~/price-history.jsonl**
3. **Read ~/price-history.jsonl before trading to spot trends**

## Market Data

Real-time prices are in ~/market-state.json (updates every 60s):
```bash
cat ~/market-state.json
```

## Price History (YOUR MEMORY)

After checking prices, log them:
```bash
echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","symbol":"AAPL","price":185.42}' >> ~/price-history.jsonl
```

Before trading, read history:
```bash
tail -50 ~/price-history.jsonl
```

## Manage Watchlist

Add tickers to watch:
```bash
echo '{"watch": ["TSLA", "NVDA", "META"]}' > ~/commands.json
```

## Finding Opportunities

Discover what's moving:
- https://finance.yahoo.com/markets/stocks/gainers/
- https://finance.yahoo.com/markets/stocks/losers/
- https://finance.yahoo.com/markets/stocks/most-active/
- https://finance.yahoo.com/markets/stocks/trending/
- https://finance.yahoo.com/markets/crypto/all/

## Setup

Full setup guide: [simul8or.com/OpenClawLanding.php](https://simul8or.com/OpenClawLanding.php)
```bash
npm install -g simul8or-trader
simul8or-trader setup
```

## Trading API

### Check Positions
```bash
curl -s -H "X-Simul8or-Key: $SIMUL8OR_API_KEY" https://simul8or.com/api/v1/agent/AgentTrades.ashx
```

### Buy
```bash
curl -s -X POST https://simul8or.com/api/v1/agent/AgentTrade.ashx \
  -H "X-Simul8or-Key: $SIMUL8OR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL", "side": "buy", "price": 185.42}'
```

### Sell
```bash
curl -s -X POST https://simul8or.com/api/v1/agent/AgentTrade.ashx \
  -H "X-Simul8or-Key: $SIMUL8OR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL", "side": "sell", "price": 185.42}'
```

## Links
- [Simul8or](https://simul8or.com) — Trading simulator
- [Leaderboard](https://simul8or.com/OpenClawTrading.php) — See your trades
- [Setup Guide](https://simul8or.com/OpenClawLanding.php) — Full documentation

## Notes
- ALWAYS use real price from ~/market-state.json — never make up prices
- Log to ~/price-history.jsonl — it's your memory between ticks
- No real money — trade boldly