Prediction markets · Venue API
Build a Polymarket trading bot with your AI coding agent.
Super Algo Kit helps you build a Polymarket trading bot or research tool inside your AI coding agent. Polymarket runs 2 separate APIs: the international order book, settled on the Polygon blockchain, and Polymarket US. The kit's default deliverables are tools such as a calibration tracker. Paper runs use the kit's paper broker on live order-book data. Live trading waits for a confirmed eligibility check for your country.
broker facts
Polymarket CLOB and US APIs
- What it is
- A prediction market where outcome shares trade on a central order book and trades settle on the Polygon blockchain.
- Two APIs
- The international CLOB API and the separate Polymarket US API, each with its own account, keys and signing.
- Login model
- International: a wallet signature creates API credentials, and every order is wallet-signed. US: Ed25519 API keys.
- Paper option
- An Amoy testnet is listed, but a working order book there is not confirmed. The kit paper broker uses live order books.
- Eligibility
- Blocked, close-only and view-only regions are reported, and VPN use to get around them is forbidden. Full list not confirmed.
- Headline limits
- Order placing is reported at 200 a second sustained, with throttling that delays requests rather than rejecting them.
- Costs
- Fees are reported to be collected onchain at match time. The fee schedule was not confirmed by the kit.
- Collateral
- Since the V2 upgrade on 28 April 2026, collateral is Polymarket USD (pUSD) and V1 clients are refused (reported).
From the kit's Polymarket card, checked 2026-09-30. Confirm current terms on Polymarket's own site.
Paper first
A Polymarket bot, built paper first.
Super Algo Kit runs inside the coding agent you already use. It interviews you, writes the spec with pass marks set first, then builds, backtests and paper-tests. Real money starts only when you type the authorize command.
The plan, step by step
Tick them off as you go.
How Polymarket API access and login work
The international API uses a wallet on Polygon that holds pUSD. The client derives API credentials from a wallet signature, and every order is signed by the wallet. So the bot holds a private key at run time, the most dangerous secret in the project.
Polymarket US is a separate product with its own account and Ed25519 API keys. An adapter for one does not work on the other. The kit never needs a password, seed phrase or 2FA seed, and it sets up keys this way.
- A dedicated wallet, never your main wallet
- A capped balance and bounded approvals
- Keys only where the bot runs, never in the agent's context
- Separate adapters for the international and US APIs
Who can use Polymarket: check eligibility first
Polymarket's geographic rules are reported to sort places into blocked, close-only and view-only. Reported examples include Ontario, Italy and Germany, plus sanctioned countries, but the full list was not confirmed. Using a VPN to get around the rules breaks Polymarket's terms (reported).
Super Algo Kit never helps you get around a venue's restrictions, by VPN, borrowed identity or any other route. Live trading waits for a confirmed eligibility check for your country. This page is not legal advice.
Paper trading a Polymarket bot
The client library lists the Amoy testnet for the international order book. Whether that testnet has a working order book, and whether Polymarket US has a sandbox, were not confirmed.
So the kit runs its own paper broker over live public order-book data and sends no orders to Polymarket. Paper fills are labelled simulated. Public markets, events and order books are reported to be readable without a key.
Polymarket rate limits and costs to plan for
Limits are reported to be per IP and enforced by throttling, so requests over the limit are delayed or queued, not rejected. Placing orders is reported at 120,000 per 10 minutes sustained, with separate buckets per signer. A slow reply can look like a timeout, so the kit treats it as an unknown outcome.
Fees are reported to be collected onchain at match time. The fee schedule, builder fees and deposit and withdrawal costs were not confirmed, so fees are modelled as marked estimates.
What Super Algo Kit does with Polymarket
The kit caps itself at 20 order requests a second per signer, far below the reported figures. Market depth, not the limit, is the real constraint, a kit judgement. It sends heartbeats on schedule, since a missed heartbeat is reported to cancel all open orders within 10 seconds.
No client order id was found, so an unclear order is matched against open orders and recent trades. More than one match goes to you. Each market's rules and resolution source are saved with a hash. An independent risk gate caps loss per market and per event, with a kill switch you can run yourself.
Before you rely on it
Gotchas to plan for.
- 2 APIs, 2 signing schemes: an adapter for one does not work on the other.
- V1 clients and V1-signed orders stopped working on production on 28 April 2026 (reported).
- The bot holds a wallet private key: use a dedicated wallet with a capped balance.
- A missed heartbeat cancels all open orders within 10 seconds (reported).
- Each market resolves by its own rules and named source; a 'price to beat' must be modelled from that source.
FAQ
Polymarket: questions.
How do I build a Polymarket trading bot with an AI coding agent?
Install Super Algo Kit in Claude Code, Codex, Cursor or another supported agent, then describe your idea in plain words. The kit interviews you, writes a strategy card and a spec with pass marks, then builds, backtests and paper-tests. The default deliverables are tools such as a calibration tracker.
How do I test a Polymarket bot without real money?
Super Algo Kit runs its own paper broker over live public order-book data and sends no orders to Polymarket. A working testnet order book is not confirmed. Live trading waits for an eligibility check and your typed authorize command.
Is Super Algo Kit affiliated with Polymarket?
No. Super Algo Kit is not affiliated with or endorsed by Polymarket. The Polymarket name is used only to say the kit works with its APIs.
Can I use a VPN to trade on Polymarket?
No. Polymarket is reported to block orders from restricted regions and to forbid VPN use to get around them. Super Algo Kit never helps get around a venue's restrictions.
Do Polymarket bots work?
Super Algo Kit makes no promise of performance, and many strategies fail. The kit's pack warns that books can be thin and that two venues' 'same' market can resolve differently. The kit's job is to test an idea properly before any money is at risk.
Keep reading
More guides.
Prediction markets · Exchange APIKalshiSuper Algo Kit helps you build a Kalshi trading bot or research tool inside your own AI coding agent.
Crypto · Exchange APIBinanceSuper Algo Kit helps you build a Binance trading bot inside your own AI coding agent.
United States · Broker APIAlpacaSuper Algo Kit helps you build an Alpaca trading bot inside your own AI coding agent.Prediction markets · Market packPrediction marketsSuper Algo Kit helps you build a prediction market bot or tool for Kalshi or Polymarket inside your own AI coding agent.Trading tool · Prediction marketsCalibration trackerA prediction market calibration tracker built with Super Algo Kit measures how well prices match how often events actually happen.Prediction markets · Comparison toolCross-venue gapsSuper Algo Kit treats prediction market arbitrage across venues as a comparison tool first, graded C.Claude Code · Coding agentClaude CodeSuper Algo Kit turns Claude Code into an algo trading team, so you can build your own Claude Code trading bot.Sources the kit's card cites
Build it with Super Algo Kit.
15 specialist roles and 35 skills inside your coding agent. Paper first, live only when you say.
Polymarket CLOB and US APIs and its logo are trademarks of their owner, used here only to say that Super Algo Kit can work with it. Super Algo Kit is not affiliated with or endorsed by Polymarket. Super Algo Kit is development software. It is not investment advice, a signal service or a promise of performance. Trading involves substantial risk, including the loss of all capital you trade with.