@apicity/polymarket

Polymarket public-data API provider — Gamma, Data, and CLOB market-data endpoints (no auth).

Installation

npm install @apicity/polymarket
# or
pnpm add @apicity/polymarket

Quick Start

import { polymarket as createPolymarket } from "@apicity/polymarket";

const polymarket = createPolymarket();

API Reference

46 endpoints across 3 groups. Each method mirrors an upstream URL path.

clob

GET https://clob.polymarket.com/book{query}

Upstream docs ↗

const res = await polymarket.clob.book({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/clob-markets/{conditionId}

Upstream docs ↗

const res = await polymarket.clob.clobMarkets({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/fee-rate/{tokenId}

Upstream docs ↗

const res = await polymarket.clob.feeRate({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/last-trade-price{query}

Upstream docs ↗

const res = await polymarket.clob.lastTradePrice({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/markets/{paramsOrConditionIdOrSignal}

Upstream docs ↗

const res = await polymarket.clob.markets({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/markets-by-token/{tokenId}

Upstream docs ↗

const res = await polymarket.clob.marketsByToken({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/midpoint{query}

Upstream docs ↗

const res = await polymarket.clob.midpoint({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/price{query}

Upstream docs ↗

const res = await polymarket.clob.price({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/prices-history{query}

Upstream docs ↗

const res = await polymarket.clob.pricesHistory({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/sampling-markets{query}

Upstream docs ↗

const res = await polymarket.clob.samplingMarkets({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/sampling-simplified-markets{query}

Upstream docs ↗

const res = await polymarket.clob.samplingSimplifiedMarkets({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/simplified-markets{query}

Upstream docs ↗

const res = await polymarket.clob.simplifiedMarkets({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/spread{query}

Upstream docs ↗

const res = await polymarket.clob.spread({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/tick-size/{tokenId}

Upstream docs ↗

const res = await polymarket.clob.tickSize({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

GET https://clob.polymarket.com/time

Upstream docs ↗

const res = await polymarket.clob.time({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/batch-prices-history

Upstream docs ↗

const res = await polymarket.clob.batchPricesHistory({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/books

Upstream docs ↗

const res = await polymarket.clob.books({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/last-trades-prices

Upstream docs ↗

const res = await polymarket.clob.lastTradesPrices({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/midpoints

Upstream docs ↗

const res = await polymarket.clob.midpoints({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/prices

Upstream docs ↗

const res = await polymarket.clob.prices({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

POST https://clob.polymarket.com/spreads

Upstream docs ↗

const res = await polymarket.clob.spreads({ /* ... */ });

Source: packages/provider/polymarket/src/clob.ts

data

GET https://data-api.polymarket.com/activity{query}

Upstream docs ↗

const res = await polymarket.data.activity({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/holders{query}

Upstream docs ↗

const res = await polymarket.data.holders({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/live-volume{query}

Upstream docs ↗

const res = await polymarket.data.liveVolume({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/oi{query}

Upstream docs ↗

const res = await polymarket.data.oi({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/positions{query}

Upstream docs ↗

const res = await polymarket.data.positions({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/trades{query}

Upstream docs ↗

const res = await polymarket.data.trades({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

GET https://data-api.polymarket.com/value{query}

Upstream docs ↗

const res = await polymarket.data.value({ /* ... */ });

Source: packages/provider/polymarket/src/data.ts

gamma

GET https://gamma-api.polymarket.com/comments/{paramsOrIdOrSignal}

Upstream docs ↗

const res = await polymarket.gamma.comments({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/comments/user_address/{address}{query}

Upstream docs ↗

const res = await polymarket.gamma.comments.byUser({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/events/{paramsOrIdOrSignal}

Upstream docs ↗

const res = await polymarket.gamma.events({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/events/keyset{query}

Upstream docs ↗

const res = await polymarket.gamma.events.keyset({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/events/slug/{slug}

Upstream docs ↗

const res = await polymarket.gamma.events.slug({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/events/{id}/tags

Upstream docs ↗

const res = await polymarket.gamma.events.tags({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/markets/{paramsOrIdOrSignal}

Upstream docs ↗

const res = await polymarket.gamma.markets({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/markets/keyset{query}

Upstream docs ↗

const res = await polymarket.gamma.markets.keyset({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/markets/slug/{slug}

Upstream docs ↗

const res = await polymarket.gamma.markets.slug({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/markets/{id}/tags

Upstream docs ↗

const res = await polymarket.gamma.markets.tags({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/public-search{query}

Upstream docs ↗

const res = await polymarket.gamma.search({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/series/{paramsOrIdOrSignal}

Upstream docs ↗

const res = await polymarket.gamma.series({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/sports

Upstream docs ↗

const res = await polymarket.gamma.sports({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/sports/market-types

Upstream docs ↗

const res = await polymarket.gamma.sports.marketTypes({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/tags/{paramsOrIdOrSignal}

Upstream docs ↗

const res = await polymarket.gamma.tags({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/tags/{id}/related-tags

Upstream docs ↗

const res = await polymarket.gamma.tags.relatedTags({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/tags/slug/{slug}/related-tags

Upstream docs ↗

const res = await polymarket.gamma.tags.relatedTags.slug({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

GET https://gamma-api.polymarket.com/tags/slug/{slug}

Upstream docs ↗

const res = await polymarket.gamma.tags.slug({ /* ... */ });

Source: packages/provider/polymarket/src/gamma.ts

Part of the apicity monorepo.

License

MIT — see LICENSE.