# Polymarket Prediction Markets API

> Polymarket events and markets with live odds, volume and liquidity, plus price history

- Vendor: `polymarketpredictionmarketsapi` · version 1.0 · category Finance · tags polymarket api, prediction market api, betting odds api, election odds api, event probability api, market price history api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/polymarketpredictionmarketsapi
- This document: https://apiclay.com/docs/polymarketpredictionmarketsapi.md
- OpenAPI 3.1: https://apiclay.com/api/polymarketpredictionmarketsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `polymarketpredictionmarketsapi`
- Updated: 2026-11-18

## About

## Polymarket Prediction Markets API

List Polymarket events and their markets with the current outcome prices (implied probabilities), volume, liquidity, open interest, dates and resolution rules, and pull a market outcome's price history.

Data comes from **polymarket.com** (https://polymarket.com). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://polymarket.com) and returns it unchanged.

Typical flow: `/events` (or `/markets`) to find a market, then `/prices-history` with one of its `clobTokenIds`.

### Routes

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | number | no | Events per page. |
| offset | query | number | no | Events to skip. |
| active | query | string | no | `true` / `false`. |
| closed | query | string | no | `false` for open events. |
| tag_slug | query | string | no | e.g. `politics`, `crypto`, `sports`. |
| slug | query | string | no | One event's slug. |
| order | query | string | no | e.g. `volume24hr`, `endDate`. |
| ascending | query | string | no | `true` / `false`. |

Returns: `[{id, slug, title, description, startDate, endDate, volume, volume24hr, liquidity, openInterest, tags, markets[]}]`; each market has `question`, `outcomes`, `outcomePrices`, `volumeNum`, `clobTokenIds`.

#### GET `/event` - Event by id
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Event `id`. |

Returns: one event as above.

#### GET `/markets` - Markets
Same paging and filters as `/events` (no `tag_slug`).

Returns: `[{id, question, slug, outcomes, outcomePrices, volumeNum, liquidity, endDate, clobTokenIds}]`.

#### GET `/prices-history` - Price history
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| token_id | query | string | yes | One of a market's `clobTokenIds` (one per outcome). |
| interval | query | string | no | `1h`, `6h`, `1d`, `1w`, `1m` or `max`. |
| fidelity | query | number | no | Resolution in minutes. |

Returns: `data[{timestamp, price, resolution_seconds}]` (price 0-1).

### Caveats

- `outcomes`, `outcomePrices` and `clobTokenIds` are JSON strings inside the JSON.
- Market data only; no trading.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by polymarket.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/polymarketpredictionmarketsapi/events`
- Public query params: `limit` (number), `offset` (number), `active` (string), `closed` (string), `tag_slug` (string), `slug` (string), `order` (string), `ascending` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /event — Event by id
- Gateway: `GET https://api.apiclay.com/v1/api/polymarketpredictionmarketsapi/event`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /markets — Markets
- Gateway: `GET https://api.apiclay.com/v1/api/polymarketpredictionmarketsapi/markets`
- Public query params: `limit` (number), `offset` (number), `active` (string), `closed` (string), `slug` (string), `order` (string), `ascending` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /prices-history — Price history
- Gateway: `GET https://api.apiclay.com/v1/api/polymarketpredictionmarketsapi/prices-history`
- Public query params: `token_id` (string, required), `interval` (string), `fidelity` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/polymarketpredictionmarketsapi/events" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
