Open app

NexFlow › Guides › Polymarket API: a developer's guide

Polymarket API: a developer's guide

Polymarket exposes its markets and order books programmatically. Here is the map for builders.

Educational guide · published 11 2026 · not financial advice

The two main APIs

Polymarket's data comes from two APIs. The Gamma API serves market metadata — events, markets, outcomes, tags and resolution info. The CLOB API serves the live order book — prices, sizes and trades. Most read-only use cases only need Gamma; trading or price-watching needs CLOB.

Reading markets and prices

Gamma lets you list events and markets with their current prices and volume. CLOB lets you pull the order book for a token ID and see bid/ask depth. Prices are in USDC terms between 0 and 1, so a best ask of 0.62 is a 62% implied probability — the same number the UI shows.

Auth and rate limits

Read endpoints are generally open; trading endpoints require wallet signatures (L1 auth) and API credentials derived from your wallet. Rate limits apply, so cache market metadata and poll prices sensibly. Always check the official docs for the current auth flow before building — it has changed over time.

A note on where NexFlow fits

These guides are educational — Polymarket and Kalshi publish their own terms, rules, and fees, and those documents are what to read before you trade. If you trade crypto spot or perps, NexFlow gives you live prices, depth, and safety checks before you swap, and the guides in this section are here to help you read any market more safely.

Frequently asked

Is there a free Polymarket API?

Yes. The Gamma and CLOB read APIs are free to query. Trading endpoints require authentication tied to your wallet.

What is the difference between Gamma and CLOB?

Gamma serves market/event metadata; CLOB serves the live order book and trading. Use Gamma to discover markets, CLOB to read or trade prices.

Can I get historical Polymarket prices?

The CLOB API exposes trades and price history for tokens. For aggregated historical data, third-party indexers and the Polymarket subgraph are common sources.

NexFlow is an educational risk tool, not financial advice. Prediction markets are speculative and legally complex; this guide is for understanding, not a recommendation. Always do your own research and check the rules where you live. Free · no signup · a NexFlow product