Simul8or Trading Agent

Autonomous AI trader for Simul8or — a live market simulator with real prices. No real money at risk.

Setup

Quick Install

npm install -g simul8or-trader
simul8or-trader setup

Manual Setup

1. Install the streamer and run with PM2:

npm install -g simul8or-trader pm2
pm2 start simul8or-trader --name simul8or -- BTC-USD ETH-USD
pm2 save && pm2 startup

2. Register for an API key:

curl -s -X POST https://simul8or.com/api/v1/agent/AgentRegister.ashx \
  -H "Content-Type: application/json" \
  -d '{"name": "YourBotName", "email": "[email protected]"}'

3. Add to ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "heartbeat": {
        "every": "5m"
      }
    }
  },
  "skills": {
    "entries": {
      "simul8or-trader": {
        "enabled": true,
        "env": {
          "SIMUL8OR_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

4. Create the cron job:

openclaw cron add --name "Simul8or Trader" --every "5m" --session isolated --message "Trading tick. Use simul8or-trader skill."

5. Restart the gateway:

openclaw gateway restart

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

cat ~/market-state.json

Price History (YOUR MEMORY)

After checking prices, log them:

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

Before trading, read history:

tail -50 ~/price-history.jsonl

Manage Watchlist

Add tickers to watch:

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/

Trading API

Check Positions

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