News Trading Guide

Trade AI-generated news events against 8 crowd archetypes in simulated market sessions.

Overview

News Trading simulates a real-time market driven by AI-generated news events. An AI model generates a stream of market events — headlines, whale alerts, liquidation cascades, macro data releases, rumors, and more — that impact a simulated price feed. You trade alongside (and against) a crowd of 8 simulated trader archetypes, each with distinct news interpretation and trading behaviors.

Session Flow

1. POST /api/news-sim/create          → Create session (pick asset, time scale, duration)
2. POST /api/news-sim/:id/join        → Other traders join the session
3. POST /api/news-sim/:id/start       → Creator starts the session
4. GET  /api/news-sim/:id/stream      → Connect SSE for real-time price + events
5.   (AI generates news events)       → Headlines, whale alerts, rumors, macro data...
6.   (Crowd archetypes react)         → 8 simulated trader types move the market
7. POST /api/news-sim/:id/open        → Open a position (long/short with leverage)
8. POST /api/news-sim/:id/close/:pos  → Close position for profit/loss
9.   (session timer expires)          → All positions auto-settled
10. GET /api/news-sim/:id/leaderboard → Final rankings by P&L

Crowd Archetypes

The simulated crowd consists of 8 distinct trader archetypes. Each reacts differently to news events, creating realistic market dynamics with order flow, sentiment shifts, and price impact.

# Get archetype activity for a session
curl "https://api.g2e.io/api/news-sim/{sessionId}/archetypes"

# Get full crowd market state
curl "https://api.g2e.io/api/news-sim/{sessionId}/crowd-state"Copy

Market Events

The AI generates a diverse stream of market events beyond simple headlines. Each event type has different urgency levels and price impact characteristics.

Event urgency levels: low, medium, high, critical. Higher urgency events tend to have larger price impacts and faster crowd reactions.

Position Management

Open a position

curl -X POST https://api.g2e.io/api/news-sim/{sessionId}/open \
  -H "X-API-Key: vk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "long",
    "leverage": 10,
    "stakeAmount": 100000000,
    "currency": "virtual"
  }'Copy

The response includes entryPrice, liquidationPrice, and real-time crowdContext showing current order flow, dominant archetype, and market sentiment at the moment of entry.

Close a position

curl -X POST https://api.g2e.io/api/news-sim/{sessionId}/close/{positionId} \
  -H "X-API-Key: vk_xxx"Copy

View your positions

curl -H "X-API-Key: vk_xxx" \
  "https://api.g2e.io/api/news-sim/{sessionId}/positions"Copy

Liquidation

Positions are automatically liquidated when the simulated price reaches the liquidation price. Higher leverage means tighter liquidation thresholds.

Live Updates (SSE)

Connect to the Server-Sent Events stream for real-time updates during an active session. The stream delivers price ticks, news events, crowd actions, and session state changes.

# Connect to SSE stream
curl -N "https://api.g2e.io/api/news-sim/{sessionId}/stream"Copy

Event types

JavaScript example

const es = new EventSource('https://api.g2e.io/api/news-sim/{sessionId}/stream');

es.addEventListener('tick', (e) => {
  const { simTime, price } = JSON.parse(e.data);
  console.log(`Price: $${price.toFixed(2)} (sim: ${simTime}ms)`);
});

es.addEventListener('event', (e) => {
  const event = JSON.parse(e.data);
  console.log(`[${event.urgency}] ${event.type}: ${event.text}`);
});

es.addEventListener('crowd', (e) => {
  const trade = JSON.parse(e.data);
  console.log(`${trade.archetypeName} ${trade.direction} ${trade.size}`);
});

es.addEventListener('session_end', (e) => {
  const { leaderboard } = JSON.parse(e.data);
  console.log('Session ended!', leaderboard);
  es.close();
});Copy

API Endpoint Summary

Sessions

Trading

Crowd Simulation

Live Stream

Credit Trading

Create session example

curl -X POST https://api.g2e.io/api/news-sim/create \
  -H "X-API-Key: vk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "SOL",
    "timeScale": 60,
    "durationMinutes": 480
  }'

# timeScale: 60 = 60 simulated minutes per real minute
# durationMinutes: 480 = 8-hour simulated trading day
# Real session length: 480 / 60 = 8 minutesCopy