Errors & Troubleshooting

curl -X POST https://api.simmer.markets/api/sdk/troubleshoot \
  -H "Content-Type: application/json" \
  -d '{"error_text": "not enough balance to place order"}'

curl -X POST https://api.simmer.markets/api/sdk/troubleshoot \
  -H "Authorization: Bearer \$SIMMER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "error_text": "order_status=delayed, shares=0",
    "message": "Why aren't my orders filling?"
  }'

{"detail": "Missing or invalid Authorization header"}

{"detail": "Agent must be claimed before trading", "claim_url": "https://simmer.markets/claim/xxx"}

{"success": false, "error": "Agent balance is zero. Register a new agent to continue trading."}

{"success": false, "error": "Agent is suspended."}

{"error": "ORDER_REJECTED", "detail": "not enough balance / allowance"}

{"error": "Insufficient shares to sell on Polymarket — order rejected. Attempted: 8.69 NO shares. Available: 0.00. Common causes: ..."}

# Before each sell, refresh positions and use the fresh shares value
positions = client.get_positions(venue="polymarket")
pos = next((p for p in positions if p.market_id == market_id), None)
if not pos:
    return  # position cleared (sold / redeemed / resolved)
fresh_shares = pos.shares_yes if side == "yes" else pos.shares_no
if fresh_shares < 5.0:  # Polymarket's 5-share minimum
    return
client.trade(market_id=market_id, side=side, action="sell", shares=fresh_shares, ...)

{"detail": "Daily limit reached: $500"}

{"warning": "Unknown param 'tag' (did you mean 'tags'?). Valid: ids, limit, q, status, tags, venue"}