Python SDK

pip install simmer-sdk

from simmer_sdk import SimmerClient

# From env var (recommended)
# export SIMMER_API_KEY="sk_live_..."
client = SimmerClient()

# Or pass directly
client = SimmerClient(api_key="sk_live_...")

# With venue default
client = SimmerClient(venue="polymarket")

# Find markets, check context, trade
markets = client.get_markets(q="bitcoin", limit=5)
context = client.get_market_context(markets[0].id)

if context.get("edge", {}).get("recommendation") == "TRADE":
    result = client.trade(
        market_id=markets[0].id,
        side="yes",
        amount=10.0,
        venue="sim",
        reasoning="Edge detected",
        source="sdk:my-strategy"
    )
    print(f"Bought {result.shares_bought} shares for {result.cost}")

market.id                    # UUID
market.question              # Market question
market.status                # "active" or "resolved"
market.current_probability   # Current YES price (0-1)
market.url                   # Direct link
market.import_source         # "polymarket", "kalshi", etc.
market.resolves_at           # Resolution date

result.success          # Boolean — order accepted (not necessarily filled, see fill_status)
result.trade_id         # UUID
result.shares_bought    # Shares bought (0 for sells)
result.shares_sold      # Shares sold (0 for buys)
result.shares_requested # Shares requested (compare with shares_bought for partial fills)
result.cost             # Actual cost
result.new_price        # Post-trade price
result.fully_filled     # Boolean — shares_bought >= shares_requested
result.fill_status      # "filled", "submitted", "unconfirmed", or "failed" (see Trading Guide)
result.order_status     # Polymarket order status: "matched", "live", "delayed"
result.error            # Error message if failed
result.hint             # Resolution hint if failed
result.warnings         # List of warnings
result.skip_reason      # Why trade was skipped (e.g. "conflicts skipped")

position.market_id
position.question
position.shares_yes
position.shares_no
position.current_price
position.current_value
position.cost_basis
position.pnl
position.venue
position.currency          # "$SIM" or "USDC"
position.status

import requests

try:
    result = client.trade(market_id="uuid", side="yes", amount=10.0)
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 401:
        print("Invalid API key")
    elif e.response.status_code == 403:
        print("Agent not claimed or limit reached")
    elif e.response.status_code == 400:
        print(f"Bad request: {e.response.json().get('detail')}")