SDKs & wrapperslibraryfree
polymarket-apis: what it does, what it costs, where it stops
Last checked 2026-09-08
polymarket-apis is a community Python library that wraps every Polymarket API in one package with Pydantic validation: read-only and authenticated CLOB clients, Gamma for markets and events, Data for positions and leaderboards, Web3 and gasless Web3 clients for on-chain operations, async and sync WebSocket clients, and a GraphQL client for the Goldsky-hosted subgraphs. Version 2.3.0 shipped June 8, 2026; the repo has 194 stars.
It predates Polymarket's own unified SDK by ten months and still covers surfaces the official package does not describe, such as subgraph queries and negative-risk conversions. It is for Python developers who want breadth in one import.
What it does
PolymarketClobClient posts and cancels limit and market orders, sends heartbeats, checks liquidity-reward scoring and reads pUSD and token balances. Signature types 0 to 3 cover EOA, Magic, Safe and Deposit wallets, and the client can detect which one an address is.
PolymarketGammaClient handles markets, events, tags, sports teams, series, comments and search. PolymarketDataClient returns positions, trades, activity, top holders, position value, PnL time series and leaderboard rank. The Web3 clients split, merge and redeem tokens, convert No tokens in negative-risk events, transfer pUSD and deploy Safe or Deposit wallets; the gasless variant routes through Polymarket's relayer so Polymarket pays gas.
- WebSocket clients cover market, user, real-time data (RTDS) and sports sockets with reconnect, heartbeats, bounded queues and health snapshots.
- GraphQL client targets eight subgraphs: activity, fpmm, open_interest, orderbook, pnl, positions, sports_oracle and wallet.
- The README opens with a written explanation of events, markets, outcomes, tokens, splits, merges and negative risk.
- PyPI: 40 releases from September 13, 2025 to June 8, 2026. Requires Python 3.12 or newer.
Pricing
Free to install. The license is not stated: there is no LICENSE file in the repo and the PyPI metadata leaves the field empty. Anyone shipping it commercially should ask the author before assuming permissive terms. Install with pip install polymarket-apis; the import name is polymarket_apis.
Venues and data
Polymarket only, but every Polymarket surface. It also reaches the Goldsky subgraphs directly, which the official SDK does not mention, and it exposes leaderboard and PnL endpoints from the Data API. Gamma also returns Polymarket's grok summaries of an event and its election market explanations by candidate and title.
Where it falls short
The missing license is the biggest gap. Python 3.12+ is a hard floor. The repo's last push was July 2, 2026 and the last release June 8, 2026, so it has not yet reacted to Polymarket's unified SDK, which first shipped July 22, 2026 and is now the venue's recommended path.
It is one author's project. Breaking changes across its 40 releases are not summarized in the README.
Who should use it
Python developers who need subgraph queries, gasless Web3 operations, leaderboards and WebSockets from a single package, and who are comfortable with an unstated license.
New integrations that only need public data and order placement should start on the official polymarket-client.
Questions about polymarket-apis (PyPI)
Is polymarket-apis official?
No. It is a community package by Razvan Gheorghe (qualiaenjoyer on GitHub). The official Python SDK is polymarket-client from Polymarket/py-sdk.
What license is polymarket-apis under?
Not stated. The repository has no LICENSE file and the PyPI license field is blank as of this check.
Does polymarket-apis support WebSockets?
Yes. AsyncPolymarketWebsocketsClient and a blocking PolymarketWebsocketsClient cover market, user, real-time data and sports sockets with reconnect and health checks.
What Python version does polymarket-apis need?
Python 3.12 or newer, per pyproject.toml and PyPI.
Official APIs for building. One book for trading.
Rather trade the spread than build the plumbing? The free Kairos terminal gives you Kalshi, Polymarket and Predict.fun in one order book.