API Playground

Explore synthetic market data generation

Configuration

Enter your API key to generate live data

Same seed = reproducible results

L2 Order Book Snapshot

{
  "timestamp": 1736582400000,
  "symbol": "BTCUSDT",
  "exchange": "binance_futures",
  "event_type": "l2_snapshot",
  "bids": [
    [94250.50, 12.5],
    [94250.00, 8.3],
    [94249.50, 15.7]
  ],
  "asks": [
    [94251.00, 10.2],
    [94251.50, 7.8],
    [94252.00, 14.3]
  ],
  "sequence": 1,
  "manifest_hash": "a3b2c1d4e5f6..."
}

Trade Event

{
  "timestamp": 1736582400125,
  "symbol": "BTCUSDT",
  "exchange": "binance_futures",
  "event_type": "trade",
  "price": 94250.75,
  "quantity": 0.45,
  "side": "buy",
  "trade_id": "sim_00001",
  "sequence": 2
}

cURL Request

curl -X POST "https://mcp.aleatoric.systems/data/generate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "config": {
      "symbol": "BTCUSDT",
      "seed": 42
    },
    "duration_seconds": 10
  }'

Python SDK

import requests

response = requests.post(
    "https://mcp.aleatoric.systems/data/generate",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "YOUR_API_KEY"
    },
    json={
        "config": {
            "symbol": "BTCUSDT",
            "seed": 42
        },
        "duration_seconds": 10
    }
)

result = response.json()
print(result["download_url"])

SSE Stream (Real-time)

const eventSource = new EventSource(
  "https://mcp.aleatoric.systems/stream/live?symbol=BTCUSDT"
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.event_type, data.price);
};

SimulationManifest Schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Trading pair (e.g., BTCUSDT)"
    },
    "seed": {
      "type": "integer",
      "description": "Random seed for reproducibility"
    },
    "volatility_regime": {
      "type": "string",
      "enum": ["low", "medium", "high", "extreme"]
    }
  },
  "required": ["symbol"]
}

Capabilities

L2

Order Book Depth

Full L2 order book snapshots with realistic bid/ask distributions

TX

Trade Flow

Synthetic trade events with realistic timing and sizing

FR

Funding Rates

Perpetual futures funding rate simulation

DT

Deterministic

Reproducible outputs with manifest hashing

Ready to integrate?

Get your API key and start generating institutional-grade synthetic market data

Get Started View Documentation