PolySimulator HFT API v1
Build and test prediction market trading bots against real-time Polymarket data, with simulated money only. PolySimulator does not place orders on Polymarket or on any other venue: every order you send here is filled against a simulated paper account.
pip install → a 5-line script → a filled trade. Start in the Quickstart.
Quick Start
Get your API key and place your first trade in under 2 minutes.
Python SDK
pip install polysimulator — the official PolySimClient. Porting a py-clob-client v1 or py-sdk bot? Drop-ins included.API Reference
Interactive playground — test every endpoint with your API key.
Example Bot
Copy-paste a working Python trading bot and start experimenting.
Why PolySimulator?
Architecture Overview
Your bot talks to a single endpoint. The API streams live order books, prices, and markets from Polymarket’s CLOB and Gamma feeds and serves them from an in-memory cache (Redis) — so your strategy reads current market data with low latency, without a database round-trip on the hot path. Orders are filled only against your simulated paper account; nothing is sent to Polymarket. Request shapes follow Polymarket’s API closely (see CLOB Compatibility).Base URL
Production:https://api.polysimulator.com
Endpoints are mounted under /v1 — append the version + path to the
base, e.g. GET https://api.polysimulator.com/v1/health. (The one
documented exception is /api/beta/cohort-status, a public read-only
endpoint used by the pricing page for residual cohort inventory.)
Keep the base URL without /v1 so each path can prepend its own
/v1 — that’s the convention the Quick Start and
API Reference use.
From Simulation to Polymarket
1
Build with PolySimulator
Develop and test your bot against the virtual API. Free keys issued
on or after 2026-09-05 trade a $100 non-renewable API wallet (free
keys issued earlier are read-only). Paid Pro / Pro+ keys trade a
simulated API wallet of $10,000 / $25,000.
2
Review your results
Review your portfolio, trade history, and equity curve. These results are
simulated and say nothing about results with real money.
3
Trading on Polymarket is separate
PolySimulator never sends orders to Polymarket. If you decide to trade on Polymarket, you do that
with your own Polymarket account, wallet and API credentials, and your code talks to Polymarket’s
API directly. PolySimulator is not involved in those trades. The
porting guide shows what changes in your code.
AI Agent Integration (MCP)
PolySimulator docs are indexed for the most common AI-coding-tool integrations — a hosted MCP server,llms.txt, the machine-readable
OpenAPI spec, and Context7 — so Cursor, Windsurf, Claude Desktop,
Continue, and similar assistants get live access to the current API
schema. See Use with AI assistants for setup configs
and example prompts.
What’s Next?
Authentication
Learn how API key auth works and create your first key.
Place a Trade
Execute market and limit orders with string-precision numerics.
WebSocket Feeds
Subscribe to real-time price updates and execution notifications.
Error Handling
Handle rate limits, errors, and build retry strategies for your bot.