Shadow Trading API Documentation

GET /api/shadow/ledger

Get current ledger state (cash, PnL, positions)

Query Parameters

ledger_path string (optional) Path to ledger file

Try it →

GET /api/shadow/report

Get comprehensive shadow trading report

Query Parameters

since_hours int (optional) Only include decisions in last N hours

Try it →

GET /api/shadow/decisions

Get paginated decision log with filtering

Query Parameters

page int (default: 1) Page number

limit int (default: 50) Items per page

market_id string (optional) Filter by market ID

category string (optional) Filter by category

Try it →

GET /api/shadow/positions

Get positions (open or all)

Query Parameters

category string (optional) Filter by category

resolved bool (optional) Filter by resolved status

Try it →

GET /api/shadow/stats

Get aggregated statistics

Query Parameters

time_range string (default: "all") today/week/month/all

Try it →

GET /api/shadow/categories

Get available categories with counts

Try it →

GET /api/shadow/risk-status

Get current risk limit status

Try it →

POST /api/shadow/run

Run a shadow trading cycle

Request Body

{
  "category": ["all"],
  "limit": 50,
  "event_limit": 100,
  "execution_mode": "pessimistic",
  "resolve_settlements": true
}

GET /api/shadow/run/{run_id}/status

Get status of a shadow run

GET /api/shadow/config

Get current configuration

Try it →

GET /health

Health check endpoint

Try it →