EthoswarmEthoswarm
← Back to Bazaar

Superior Trade Polymarket

Copied!
Verified

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.

Equipped By
1Minds
Comprised Of
9App Tools
App Tools
9
SuperiorTrade_CreatePolymarketBacktestPOST

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.

SuperiorTrade_DepositToPolymarketPOST

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.

SuperiorTrade_ExitPolymarketPortfolioPOST

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.

SuperiorTrade_GetPolymarketBacktestGET

Read the persisted backtest record — the planned request plus current status metadata. GET /v3/backtest/{id}. 404 on not-found.

SuperiorTrade_GetPolymarketBacktestLogsGET

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.

SuperiorTrade_GetPolymarketBacktestResultGET

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.

SuperiorTrade_GetPolymarketBacktestStatusGET

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.

SuperiorTrade_SearchPolymarketMarketsPOST

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).

SuperiorTrade_SendPolymarketOrderPOST

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.