Polymarket API

Polymarket events, markets, odds, order books, price history and trades as clean JSON.

The API.SH Polymarket API returns public prediction-market data as JSON. List or search events and markets with filters for status, tag, volume, liquidity and dates. Read a market's outcomes with prices and token ids, volume, liquidity, best bid and ask, spread and resolution status. Pull the live order book, an outcome's price history and recent trades.

Get a free API key Try it in the playground

7 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Polymarket search

GET https://api.api.sh/polymarket/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Polymarket API

Odds tracking and dashboards

Search events, read outcome prices and watch volume and liquidity for the markets you care about.

/search /market /event

Market screening

Filter events or markets by status, tag, series, minimum volume or liquidity and end date, sorted by volume or recency.

/events /markets

Probability history and research

Pull an outcome's implied probability over time, by preset interval or custom range, for charts and backtests.

/price-history

Liquidity and spread analysis

Read bid and ask levels, spread, midpoint and total size per side for any outcome.

/orderbook /market

Trade flow monitoring

Follow recent trades by side, outcome, minimum size or minimum value, with the trader's public wallet and pseudonym.

/trades

News and forecasting agents

Give an AI agent market search and prices so it can cite what the crowd currently expects for an event.

/search /event

Polymarket data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Polymarket API endpoints and prices

Every Polymarket endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Polymarket search

/polymarket/v1/search

$1 · $2 PAYG

1 credit

Posts and media1

Polymarket outcome price history

/polymarket/v1/price-history

$1 · $2 PAYG

1 credit

Products, listings and places3

Polymarket event detail /polymarket/v1/event	$1 · $2 PAYG 1 credit
Polymarket events /polymarket/v1/events	$1 · $2 PAYG 1 credit
Polymarket order book /polymarket/v1/orderbook	$1 · $2 PAYG 1 credit

More data3

Polymarket market detail /polymarket/v1/market	$1 · $2 PAYG 1 credit
Polymarket markets /polymarket/v1/markets	$1 · $2 PAYG 1 credit
Polymarket market trades /polymarket/v1/trades	$1 · $2 PAYG 1 credit

Call the Polymarket API

Polymarket search: GET https://api.api.sh/polymarket/v1/search

curl "https://api.api.sh/polymarket/v1/search?q=bitcoin" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/polymarket/v1/search",
    params={"q": "bitcoin"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/polymarket/v1/search");
url.searchParams.set("q", "bitcoin");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/polymarket/v1/search", "q", "bitcoin")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Polymarket" and "Polymarket search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Polymarket data

Public data only: no Polymarket login, cookies or account needed
One key and one response shape for Polymarket and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Polymarket API

Polymarket documents several official APIs, including the Gamma API for market data, a CLOB API for order books and trading, a Data API and a separate Polymarket US API with its own authentication. API.SH is read-only and needs no keys: one key and one JSON shape for events, markets, order books, price history and trades.

Skip running your own Polymarket scraper or stitching Gamma and CLOB calls together, or paying for an Apify actor: API.SH gives you one key and a fixed price per call.

Polymarket API questions

What Polymarket data can I get?+

Event search (/polymarket/v1/search), events with filters (/polymarket/v1/events), one event with all its markets (/polymarket/v1/event), market lists (/polymarket/v1/markets), one market (/polymarket/v1/market), the live order book (/polymarket/v1/orderbook), outcome price history (/polymarket/v1/price-history) and recent trades (/polymarket/v1/trades).

How much does the Polymarket API cost?+

Every Polymarket endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /polymarket/v1/event at 1 credit each.

Is there an official Polymarket API?+

Yes. Polymarket documents several APIs at docs.polymarket.com, including Gamma for market data and a CLOB API for order books and trading, plus a separate Polymarket US API. API.SH is read-only: it returns public market data as JSON without Polymarket keys or a wallet.

Do I need a Polymarket account, key or wallet?+

No. API.SH reads public Polymarket data only. No endpoint uses a login, a wallet or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /polymarket/v1/search with q set to a topic such as an election or a rate decision. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Is there a free Polymarket API?+

Polymarket's market-data APIs are documented on its developer site. Through API.SH you can start free: every account gets 1,000 free credits every month. That is 1,000 calls to /polymarket/v1/event at 1 credit each.

Can I get Polymarket historical odds and order books?+

Yes. /polymarket/v1/price-history returns an outcome's implied probability over time, by preset interval or by start and end, and /polymarket/v1/orderbook returns the live bid and ask levels. It does not place trades or read private wallets.