WS /v1/ws/executions?token=<jwt>

# Mint a WS token
TOKEN=$(curl -s -X POST -H "X-API-Key: $API_KEY" \
  https://api.polysimulator.com/v1/keys/ws-token | jq -r '.token')

# Connect
wscat -c "wss://api.polysimulator.com/v1/ws/executions?token=$TOKEN"

{
  "type": "fill",
  "order_id": 42,
  "market_id": "0x1a2b3c...",
  "side": "BUY",
  "outcome": "Yes",
  "price": "0.65",
  "quantity": "10.0",
  "filled_at": "2026-02-06T12:00:45Z"
}

import asyncio
import json
import requests
import websockets

API_KEY = "ps_live_..."
BASE = "https://api.polysimulator.com/v1"
headers = {"X-API-Key": API_KEY}

# 1. Place a limit order
order = requests.post(f"{BASE}/orders", headers=headers, json={
    "market_id": "0x1a2b3c...",
    "side": "BUY",
    "outcome": "Yes",
    "quantity": "10",
    "order_type": "limit",
    "price": "0.60",
    "time_in_force": "GTC",
    "client_order_id": "limit-001",
}).json()

print(f"Limit order placed: {order['status']}")

# 2. Listen for fills
ws_token = requests.post(
    f"{BASE}/keys/ws-token", headers=headers
).json()["token"]

async def listen_fills():
    async with websockets.connect(
        f"wss://api.polysimulator.com/v1/ws/executions?token={ws_token}"
    ) as ws:
        async for raw in ws:
            msg = json.loads(raw)
            # Fill frames are FLAT (no `data` wrapper) and use type == "fill".
            if msg.get("type") == "fill":
                print(f"Filled: {msg['side']} {msg['quantity']}x {msg['outcome']} @ {msg['price']}")

asyncio.run(listen_fills())