---
id: polymarket-client
version: "0.6.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# polymarket-client — Official Python client for Polymarket

License: permissive · Maintenance: active · Downloads: 77.5K/mo

## What it is and what it does

polymarket-client is the official Python SDK for Polymarket, a prediction market platform. It provides both synchronous and asynchronous clients to interact with Polymarket's API, supporting workflows from simple market data queries to authenticated trading and wallet operations. The SDK abstracts away the complexity of HTTP requests, web3 signing, and session management, offering a coherent interface for developers building on Polymarket.

The package is built on standard web3 libraries (eth-abi, eth-account, eth-utils) for cryptographic operations and httpx/websockets for network I/O. It supports batch operations like merging multiple market or combo positions, and includes both public (unauthenticated) and authenticated client modes. The SDK is in beta (0.x versioning) and explicitly marks Perps APIs as experimental, meaning breaking changes are possible in minor releases, though the maintainers aim to provide deprecation paths.

Use it for:

- Fetch real-time market data and order books from Polymarket without authentication for public analysis or dashboards
- Build automated trading bots that place orders, manage positions, and monitor account state using authenticated client workflows
- Batch merge multiple market positions by condition ID, market ID, or position ID to consolidate holdings
- Stream live market updates and position changes using async client subscriptions for reactive applications
- Integrate Polymarket trading into larger Python applications that already use web3 libraries like eth-account

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Official Python SDK for Polymarket that provides a unified interface to query public market data, manage authenticated accounts, execute trades, and handle wallet workflows on the Polymarket prediction market platform.

Yes. The SDK is actively maintained (released 1 day ago), has no known vulnerabilities, and offers low installation friction. It is the official client for Polymarket, making it the natural choice for Python developers building on the platform. The main caveat is that 0.x versioning means breaking changes are possible in minor releases, and Perps APIs are explicitly experimental—suitable for production use of core trading workflows but warrant caution if relying on newer features.

## Install

pip install polymarket-client
uv add polymarket-client
poetry add polymarket-client

## Installing polymarket-client

Before you install: Low friction install with a pure-Python wheel distribution. Actively maintained with a release just 1 day old and 100 repository stars. Dependencies are standard web3 and HTTP libraries (eth-abi, eth-account, eth-utils, httpx, pydantic, websockets) with no compiled components.

License in practice: MIT license is permissive and imposes no significant restrictions on use, modification, or distribution. Suitable for commercial and private projects without copyleft obligations.

Quickstart:

from polymarket import PublicClient, Market

with PublicClient() as client:
    market: Market = client.get_market(
        url="https://polymarket.com/event/example-market"
    )

Requires Python 3.11 or later. Authenticated workflows require a Polymarket private key or builder API key.

Verify before relying:

- Whether the SDK's experimental Perps APIs are stable enough for production use despite the breaking-change caveat on 0.x releases
- Real-world latency and throughput characteristics for batch position merges and streaming subscriptions
- Completeness of error handling and retry logic for network failures or rate limits

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 77.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

polymarket python client, prediction market trading sdk, web3 market data api, polymarket account management, async market trading library, polymarket position merging, ethereum prediction markets, prediction-markets, web3-trading, async-client

[View on SkillFed](https://skillfed.io/packages/polymarket-client) · [View on PyPI](https://pypi.org/project/polymarket-client/)