API Overview

https://api.simmer.markets

Authorization: Bearer sk_live_xxx

curl https://api.simmer.markets/api/sdk/health

{
  "status": "ok",
  "timestamp": "2026-02-10T12:00:00Z",
  "version": "1.10.0"
}

{
  "detail": "Daily limit reached",
  "hint": "Upgrade your limits in the dashboard"
}

curl -H "Authorization: Bearer $SIMMER_API_KEY" \
  "https://api.simmer.markets/api/sdk/user/settings"

curl -X PATCH https://api.simmer.markets/api/sdk/user/settings \
  -H "Authorization: Bearer $SIMMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_trades_per_day": 200,
    "max_position_usd": 100.0,
    "auto_risk_monitor_enabled": true,
    "trading_paused": false
  }'

curl -X PATCH https://api.simmer.markets/api/sdk/settings \
  -H "Authorization: Bearer $SIMMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "auto_risk_monitor_enabled": true,
    "default_stop_loss_pct": 0.50,
    "default_take_profit_pct": 0
  }'

{
  "error": "Rate limit exceeded",
  "limit": 12,
  "x402_url": "https://x402.simmer.markets/api/sdk/context/your-market-id",
  "x402_price": "$0.005"
}

# pip install x402[httpx,evm]
import httpx
from eth_account import Account
from x402.clients import x402_payment_hooks

account = Account.from_key("0x_YOUR_WALLET_KEY")

async def get_context(market_id: str):
    async with httpx.AsyncClient() as free_client:
        resp = await free_client.get(
            f"https://api.simmer.markets/api/sdk/context/{market_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        if resp.status_code == 429:
            x402_url = resp.json().get("x402_url")
            async with httpx.AsyncClient() as paid_client:
                paid_client.event_hooks = x402_payment_hooks(account)
                resp = await paid_client.get(
                    x402_url,
                    headers={"Authorization": f"Bearer {API_KEY}"}
                )
        return resp.json()

import random, time

INTERVAL = 30  # seconds between checks

while True:
    briefing = client.get_briefing()
    # ... process positions, opportunities, trades
    time.sleep(INTERVAL + random.uniform(0, 10))  # 30-40s instead of exactly 30s