Superior Trade Polymarket
Nine-tool Superior Trade API v3 client for Polymarket prediction markets. Deposits USDC to pUSD, exits the portfolio (kill-switch), sends CLOB orders (place market + cancel by id), searches candidate markets with coverage/backtest/deployment hints, and runs the full backtest family (create + status + result + logs). Three of nine tools move real money (DepositToPolymarket, ExitPolymarketPortfolio, SendPolymarketOrder). Auth via superior-trade x-api-key against a Superior-managed wallet. Semver 1.0.0.
Plan a Polymarket backtest job. POST /v3/backtest. Simulated funds — NOT on the real-money gate list. NautilusTrader TradeTick replay: fills come from real historical trades, not candles. tenantId is stable per-Steward — REUSE for every backtest. marketSlugs are exact from SearchPolymarketMarkets (min 1), never invented. timerange holds ISO-8601 date-times INSIDE the candidate's coverage window. venueProfile 'polymarket-london'. strategySource is inline Nautilus Python (max 262144 chars) — drive from on_trade_tick (quote-only strategies get ZERO callbacks in replay). strategyConfig field names must match the strategy's StrategyConfig class. Infrastructure fields (datasetRef, datasetPrefix, resultPrefix, resultBucket, codeRef, configRef) deliberately NOT exposed — never invent.
Deposit USDC to Polymarket pUSD. POST /v3/portfolio/polymarket/deposit. Real money tool — moves USDC from a Superior-managed wallet to the Polymarket pUSD balance. chain + asset_address + amount + from are REQUIRED; route is OPTIONAL (server default when omitted). Vendor minimum 5 USDC. Money confirmation gate required before any call.
Exit the Polymarket portfolio — kill-switch that cancels every open order and sells every position. POST /v3/portfolio/polymarket/exit. Real money tool — moves positions. tradingAccountId is OPTIONAL (omitted = DEFAULT Superior wallet). Money confirmation gate required. EXCLUDED from wire sweep by design: no malformed call fails safely — a passing call is indistinguishable from unauthorized liquidation.
Read the persisted backtest record — the planned request plus current status metadata. GET /v3/backtest/{id}. 404 on not-found.
Read Kubernetes Job logs — the diagnostic surface for failed or stuck runs; read these BEFORE changing strategy code. GET /v3/backtest/{id}/logs. Paginated via pageSize plus the pageToken returned by the previous response. 404 on not-found.
Read the backtest result JSON. GET /v3/backtest/{id}/result. Returns 202 while result still uploading — retry after a short wait. Then balances (pUSD), total_pnl, return, orders, fills, dataset_provenance. Trades capped at FIRST 50 fills. Win rate / Sharpe / drawdown NOT computed server-side — derive from trades/positions when asked, say trades-list capped when relevant. ZERO FILLS = strategy never traded — do NOT offer deployment. 202 (retry) + 404 beyond shared model.
Poll backtest status — progression pending ? running ? completed or failed. GET /v3/backtest/{id}/status. Typical runs 1-30 seconds; poll ~every 5s with 5-minute budget, then check logs. 404 on not-found.
Search Polymarket candidate markets. POST /v3/markets/search. READ via POST (no side effects). query accepts natural-language / exact slug / polymarket.com URL (pass URLs whole, never parse). Returns ranked candidates with slug/question/volume/liquidity/coverage {start,end}/dataMode/coverageStatus/backtestSupported/deploymentSupported. status 'not_found' = no match — NEVER invent a slug. For backtest require coverageStatus 'available' AND backtestSupported true (metadata_only markets not backtestable yet).
Send a Polymarket CLOB order (placeMarketOrder or cancelOrder). POST /v3/authorize-and-send/polymarket. Real money tool — submits against the live CLOB. action.type is one of placeMarketOrder or cancelOrder. Vendor minimums ~5 pUSD / 5 shares; rate limit ~30 orders/min; exactly ONE request per confirmed action — never auto-retry, never fabricate fills. Probe ONLY the cancelOrder variant against a nonexistent id.
Overview
Nine-tool Superior Trade API v3 client for Polymarket prediction markets. Deposits USDC to pUSD, exits the portfolio (kill-switch), sends CLOB orders (place market + cancel by id), searches candidate markets with coverage/backtest/deployment hints, and runs the full backtest family (create + status + result + logs). Three of nine tools move real money (DepositToPolymarket, ExitPolymarketPortfolio, SendPolymarketOrder). Auth via superior-trade x-api-key against a Superior-managed wallet. Semver 1.0.0. It gives your AI agent 9 built-in tools, including superior trade create polymarket backtest, superior trade deposit to polymarket and superior trade exit polymarket portfolio. Apps are free to equip, and once equipped your AI Mind can use Superior Trade Polymarket automatically while it works. Superior Trade Polymarket is currently equipped on 1 Mind.
Frequently asked questions
What is Superior Trade Polymarket?
Nine-tool Superior Trade API v3 client for Polymarket prediction markets. Deposits USDC to pUSD, exits the portfolio (kill-switch), sends CLOB orders (place market + cancel by id), searches candidate markets with coverage/backtest/deployment hints, and runs the full backtest family (create + status + result + logs). Three of nine tools move real money (DepositToPolymarket, ExitPolymarketPortfolio, SendPolymarketOrder). Auth via superior-trade x-api-key against a Superior-managed wallet. Semver 1.0.0. It bundles 9 tools your AI agent can call on your behalf.
What can Superior Trade Polymarket do for my AI agent?
Once equipped, your AI Mind can use Superior Trade Polymarket to superior trade create polymarket backtest, superior trade deposit to polymarket, superior trade exit polymarket portfolio, superior trade get polymarket backtest and superior trade get polymarket backtest logs, and more — without you having to do any of it manually.
How do I connect Superior Trade Polymarket to my AI Mind?
Open Superior Trade Polymarket in the Ethoswarm Bazaar and select Equip to add it to one of your AI Minds. Your Mind can then use it automatically. Some apps ask you to authorize access the first time they run.
Is Superior Trade Polymarket free?
Yes — Superior Trade Polymarket is free to equip on your AI Mind in the Ethoswarm Bazaar.