@apicity/polymarket
v0.7.3
Published
Polymarket API provider — Gamma, Data, and CLOB market-data/trading endpoints.
Maintainers
Readme
@apicity/polymarket
Polymarket API provider — Gamma, Data, and CLOB market-data/trading endpoints.
Runtime dependencies:
viem@^2.52.2— EIP-712 order signing for the CLOB trading endpointszod@^4.4.3— request schemas attached to every POST endpoint as.schema
Installation
npm install @apicity/polymarket
# or
pnpm add @apicity/polymarketQuick Start
import { createPolymarket } from "@apicity/polymarket";
const polymarket = createPolymarket();Unsupported Upstream Paths
The current Polymarket OpenAPI specs mark some paths as x-excluded; @apicity/polymarket intentionally does not expose wrappers for those unsupported surfaces. That includes Gamma administrative/private paths such as team detail, event pagination/results/comment-count, market information and abridged POST endpoints, series summaries, and private profile lookups, plus Data /revisions and /other.
API Reference
108 endpoints across 3 groups. Each method mirrors an upstream URL path.
clob
DELETE https://clob.polymarket.com/auth/api-key
Cost tier: cheap
const res = await polymarket.clob.auth.apiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/auth/builder-api-key
Cost tier: cheap
const res = await polymarket.clob.auth.builderApiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/cancel-all
Cost tier: cheap
const res = await polymarket.clob.cancelAll({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/cancel-market-orders
Cost tier: cheap
const res = await polymarket.clob.cancelMarketOrders({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/notifications{query}
Cost tier: cheap
const res = await polymarket.clob.notifications({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/order
Cost tier: cheap
const res = await polymarket.clob.order({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
DELETE https://clob.polymarket.com/orders
Cost tier: cheap
const res = await polymarket.clob.orders({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/auth/api-keys
Cost tier: cheap
const res = await polymarket.clob.auth.apiKeys({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/auth/ban-status/closed-only
Cost tier: cheap
const res = await polymarket.clob.auth.banStatus.closedOnly({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/auth/builder-api-key
Cost tier: cheap
const res = await polymarket.clob.auth.builderApiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/auth/derive-api-key
Cost tier: cheap
const res = await polymarket.clob.auth.deriveApiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/balance-allowance{query}
Cost tier: cheap
const res = await polymarket.clob.balanceAllowance({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/balance-allowance/update{query}
Cost tier: cheap
const res = await polymarket.clob.balanceAllowance.update({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/book{query}
Cost tier: cheap
const res = await polymarket.clob.book({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/books{query}
Cost tier: cheap
const res = await polymarket.clob.books({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/builder/trades{query}
Cost tier: cheap
const res = await polymarket.clob.builderTrades({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/clob-markets/{conditionId}
Cost tier: cheap
const res = await polymarket.clob.clobMarkets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/data/order/{orderID}
Cost tier: cheap
const res = await polymarket.clob.data.order({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/data/orders{query}
Cost tier: cheap
const res = await polymarket.clob.data.orders({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/data/trades{query}
Cost tier: cheap
const res = await polymarket.clob.data.trades({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/fee-rate/{tokenId}
Cost tier: cheap
const res = await polymarket.clob.feeRate({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/fee-rate{query}
Cost tier: cheap
const res = await polymarket.clob.feeRateByQuery({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/last-trade-price{query}
Cost tier: cheap
const res = await polymarket.clob.lastTradePrice({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/last-trades-prices{query}
Cost tier: cheap
const res = await polymarket.clob.lastTradesPrices({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/markets/live-activity/{conditionId}
Cost tier: cheap
const res = await polymarket.clob.marketLiveActivity({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/markets/{paramsOrConditionIdOrSignal}
Cost tier: cheap
Legacy compatibility: current public market discovery is documented on the Gamma
/marketspages. The CLOB/marketscompatibility path is retained for existing callers and is documented by the CLOB OpenAPI spec.
const res = await polymarket.clob.markets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/markets-by-token/{tokenId}
Cost tier: cheap
const res = await polymarket.clob.marketsByToken({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/midpoint{query}
Cost tier: cheap
const res = await polymarket.clob.midpoint({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/midpoints{query}
Cost tier: cheap
const res = await polymarket.clob.midpoints({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/neg-risk/{tokenId}
Cost tier: cheap
const res = await polymarket.clob.negRisk({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/neg-risk{query}
Cost tier: cheap
const res = await polymarket.clob.negRiskByQuery({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/notifications{query}
Cost tier: cheap
const res = await polymarket.clob.notifications({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/order-scoring{query}
Cost tier: cheap
const res = await polymarket.clob.orderScoring({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/orders-scoring{query}
Cost tier: cheap
const res = await polymarket.clob.ordersScoring({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/price{query}
Cost tier: cheap
const res = await polymarket.clob.price({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/prices{query}
Cost tier: cheap
const res = await polymarket.clob.prices({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/prices-history{query}
Cost tier: cheap
const res = await polymarket.clob.pricesHistory({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rebates/current{query}
Cost tier: cheap
const res = await polymarket.clob.rebates.current({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/markets/{conditionId}{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.markets.byCondition({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/markets/current{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.markets.current({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/markets/multi{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.markets.multi({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/user{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.user({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/user/markets{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.userMarkets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/user/percentages{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.userPercentages({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/rewards/user/total{query}
Cost tier: cheap
const res = await polymarket.clob.rewards.userTotal({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/sampling-markets{query}
Cost tier: cheap
const res = await polymarket.clob.samplingMarkets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/sampling-simplified-markets{query}
Cost tier: cheap
const res = await polymarket.clob.samplingSimplifiedMarkets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/simplified-markets{query}
Cost tier: cheap
const res = await polymarket.clob.simplifiedMarkets({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/spread{query}
Cost tier: cheap
const res = await polymarket.clob.spread({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/tick-size/{tokenId}
Cost tier: cheap
const res = await polymarket.clob.tickSize({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/tick-size{query}
Cost tier: cheap
const res = await polymarket.clob.tickSizeByQuery({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
GET https://clob.polymarket.com/time
Cost tier: cheap
const res = await polymarket.clob.time({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/auth/api-key
Cost tier: cheap
const res = await polymarket.clob.auth.apiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/auth/builder-api-key
Cost tier: cheap
const res = await polymarket.clob.auth.builderApiKey({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/batch-prices-history
Cost tier: cheap
const res = await polymarket.clob.batchPricesHistory({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/books
Cost tier: cheap
const res = await polymarket.clob.books({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/heartbeats
Cost tier: cheap
const res = await polymarket.clob.heartbeats({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/last-trades-prices
Cost tier: cheap
const res = await polymarket.clob.lastTradesPrices({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/markets/live-activity
Cost tier: cheap
const res = await polymarket.clob.marketsLiveActivity({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/midpoints
Cost tier: cheap
const res = await polymarket.clob.midpoints({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/order
Cost tier: cheap
const res = await polymarket.clob.order({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/orders
Cost tier: cheap
const res = await polymarket.clob.orders({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/orders-scoring
Cost tier: cheap
const res = await polymarket.clob.ordersScoring({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/order
Cost tier: cheap
const res = await polymarket.clob.placeOrder({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/prices
Cost tier: cheap
const res = await polymarket.clob.prices({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/spreads
Cost tier: cheap
const res = await polymarket.clob.spreads({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
POST https://clob.polymarket.com/v1/heartbeats
Cost tier: cheap
const res = await polymarket.clob.v1.heartbeats({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
PUT https://clob.polymarket.com/balance-allowance{query}
Cost tier: cheap
const res = await polymarket.clob.balanceAllowance({ /* ... */ });Source: packages/provider/polymarket/src/clob.ts
data
GET https://data-api.polymarket.com/v1/accounting/snapshot{query}
Cost tier: cheap
const res = await polymarket.data.accounting.snapshot({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/activity{query}
Cost tier: cheap
const res = await polymarket.data.activity({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/activity/combos{query}
Cost tier: cheap
const res = await polymarket.data.activity.combos({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/builders/leaderboard{query}
Cost tier: cheap
const res = await polymarket.data.builders.leaderboard({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/builders/volume{query}
Cost tier: cheap
const res = await polymarket.data.builders.volume({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/closed-positions{query}
Cost tier: cheap
const res = await polymarket.data.closedPositions({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/
Cost tier: cheap
const res = await polymarket.data.health({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/holders{query}
Cost tier: cheap
const res = await polymarket.data.holders({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/leaderboard{query}
Cost tier: cheap
const res = await polymarket.data.leaderboard({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/live-volume{query}
Cost tier: cheap
const res = await polymarket.data.liveVolume({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/market-positions{query}
Cost tier: cheap
const res = await polymarket.data.marketPositions({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/oi{query}
Cost tier: cheap
const res = await polymarket.data.oi({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/positions{query}
Cost tier: cheap
const res = await polymarket.data.positions({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/v1/positions/combos{query}
Cost tier: cheap
const res = await polymarket.data.positions.combos({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/traded{query}
Cost tier: cheap
const res = await polymarket.data.traded({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/trades{query}
Cost tier: cheap
const res = await polymarket.data.trades({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
GET https://data-api.polymarket.com/value{query}
Cost tier: cheap
const res = await polymarket.data.value({ /* ... */ });Source: packages/provider/polymarket/src/data.ts
gamma
GET https://gamma-api.polymarket.com/comments/{paramsOrIdOrSignal}
Cost tier: cheap
const res = await polymarket.gamma.comments({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/comments/user_address/{address}{query}
Cost tier: cheap
const res = await polymarket.gamma.comments.byUser({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/events/{paramsOrIdOrSignal}
Cost tier: cheap
Deprecated upstream: the replay fixture for the list form
GET /events?...returnedDeprecation: true,Sunset: Fri, 01 May 2026 00:00:00 GMT, andWarning: 299 - "use /events/keyset". This compatibility method remains for existing bare-array/eventscallers; preferpolymarket.gamma.events.keyset()for new paginated event lists.
const res = await polymarket.gamma.events({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/events/keyset{query}
Cost tier: cheap
const res = await polymarket.gamma.events.keyset({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/events/slug/{slug}
Cost tier: cheap
const res = await polymarket.gamma.events.slug({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/events/{id}/tags
Cost tier: cheap
const res = await polymarket.gamma.events.tags({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/markets/{paramsOrIdOrSignal}
Cost tier: cheap
const res = await polymarket.gamma.markets({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/markets/keyset{query}
Cost tier: cheap
const res = await polymarket.gamma.markets.keyset({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/markets/slug/{slug}
Cost tier: cheap
const res = await polymarket.gamma.markets.slug({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/markets/{id}/tags
Cost tier: cheap
const res = await polymarket.gamma.markets.tags({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/public-profile{query}
Cost tier: cheap
const res = await polymarket.gamma.publicProfile({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/public-search{query}
Cost tier: cheap
const res = await polymarket.gamma.search({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/series/{paramsOrIdOrSignal}
Cost tier: cheap
const res = await polymarket.gamma.series({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/sports
Cost tier: cheap
const res = await polymarket.gamma.sports({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/sports/market-types
Cost tier: cheap
const res = await polymarket.gamma.sports.marketTypes({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/status
Cost tier: cheap
const res = await polymarket.gamma.status({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/tags/{paramsOrIdOrSignal}
Cost tier: cheap
const res = await polymarket.gamma.tags({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/tags/{id}/related-tags{query}
Cost tier: cheap
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{query}
Cost tier: cheap
const res = await polymarket.gamma.tags.relatedTags.slug({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/tags/{id}/related-tags/tags{query}
Cost tier: cheap
const res = await polymarket.gamma.tags.relatedTags.tags({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/tags/slug/{slug}/related-tags/tags{query}
Cost tier: cheap
const res = await polymarket.gamma.tags.relatedTags.tags.slug({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/tags/slug/{slug}
Cost tier: cheap
const res = await polymarket.gamma.tags.slug({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
GET https://gamma-api.polymarket.com/teams{query}
Cost tier: cheap
const res = await polymarket.gamma.teams({ /* ... */ });Source: packages/provider/polymarket/src/gamma.ts
Part of the apicity monorepo.
License
MIT — see LICENSE.
