For builders

Polymarket API for bots: the intelligence layer your bot is missing

Polymarket's official API gives your bot prices and order placement. It doesn't tell you who is on the other side of the book. CrowdIntel is a read-only intelligence API over 1.7B indexed on-chain trades — wallet scores, insider signals, whale tape, funding clusters, and webhooks — built to be the decision layer under a trading bot or agent.

Short answer

Use two APIs. Polymarket's official CLOB API for execution — order books, prices, order placement. CrowdIntel for intelligence — which wallets are sharp, which are coordinated clusters, what the whale flow says, and how a signal would have performed historically. CrowdIntel is read-only (OpenAPI 3.1, Bearer auth, cursor pagination) and ships on the Terminal plan ($99/mo) with webhooks included.

What a bot actually needs beyond prices

Every Polymarket trade settles on Polygon, so the entire history of every wallet is public. CrowdIntel indexes all of it — 1.7B on-chain trades since 2020, 3M wallets profiled — and computes the things a raw price feed can't give you: resolved-outcome win rates per wallet, an 8-signal suspicion score, entry-timing edge, and funding-graph clusters that link coordinated wallets to one operator.

That means your bot can ask questions like “is the wallet moving this market a proven category specialist or a first-time gambler?” and “are these five wallets independent flow or one funder?” — before it sizes a position.

The API surface

Read-only REST under /api/v1. Full reference with request/response schemas at the API docs.

/api/v1/walletsWallets
Per-wallet dossiers: aggregate stats, resolved-outcome PnL, trade history, entry-timing edge, category breakdowns, and connected/correlated wallets.
/api/v1/signalsSignals
Insider-score signals per wallet or market, fresh movers, and a screener for category specialists whose edge beats their global record.
/api/v1/tradesTrades
The fill tape — filter by wallet, market, side, size, or a bounded time window. Cursor keyset pagination over the 1.7B-fill index.
/api/v1/marketsMarkets
Per-market detail, money flow, whale sentiment, trending and moving markets.
/api/v1/leaderboardsLeaderboards
Ranked wallets by PnL, win rate, or category — with minimum-sample skill filters.
/api/v1/clustersClusters
Funding clusters: resolve any wallet's cluster, walk the funding graph, and screen sybil cohorts.
/api/v1/backtestBacktest
Hosted signal backtests — replay whale/insider signals over historical resolved markets with stake rules and fee assumptions.
/api/v1/webhooksWebhooks
Push whale and insider alerts into your bot instead of polling.

Webhooks: push, don't poll

Whale and insider alerts can be pushed into your stack instead of burning your rate limit polling. Register a webhook, receive alerts as they fire, and keep your request budget for research queries. Setup guide in the webhook docs.

Building an AI agent instead of a bot?

The same data is exposed over a remote MCP server — 16 read-only tools that Claude, Cursor, or any MCP client can call directly. MCP starts on the Pro plan ($29/mo); the REST API starts on Terminal ($99/mo). Use MCP when an AI reads the data conversationally, REST when your own code does.

FAQ

Does Polymarket have an official API for bots?

Yes — Polymarket's official CLOB API (docs.polymarket.com) handles order placement, order books, and live prices. That's the execution layer. CrowdIntel is the intelligence layer on top: read-only wallet scores, insider signals, funding clusters, and resolved-outcome PnL computed from 1.7B indexed on-chain trades — data the official API doesn't expose. Most bots use both: official API to trade, CrowdIntel to decide.

What data does the CrowdIntel API expose?

Read-only REST endpoints under /api/v1 covering wallets (stats, trade history, timing edge, connections), insider signals, the trade tape, markets and money flow, leaderboards, funding clusters, hosted backtests, and webhooks. OpenAPI 3.1 spec, Bearer auth, cursor pagination, snake_case JSON.

Can my bot place orders through CrowdIntel?

No. CrowdIntel is deliberately read-only — it never custodies funds or executes trades. For execution, use Polymarket's official CLOB API, or a unified trading API like Synthesis if you need Polymarket and Kalshi under one surface. CrowdIntel supplies the signal; the strategy and execution stay yours.

What does API access cost?

The REST API ships on the Terminal plan ($99/mo, 1,000 requests/hr, 50k/mo) and includes webhooks. Terminal Pro ($299/mo) raises limits to 5,000 req/hr and 250k/mo and adds the hosted Backtest API. The MCP server starts on Pro ($29/mo) if you want an AI agent reading the same data conversationally.

Start building

Read the API reference, skim the quickstart, or compare plans. Related: how to backtest a Polymarket strategy and what historical data is available.