--- url: "https://predictiontoolkit.com/tools/polymarket-python-sdk/" publisher: "PredictionToolkit" dateModified: "2026-11-02" --- [← SDKs & libraries]() ![Polymarket Python SDK logo]() SDK # Polymarket Python SDK: from notebook research to async services The official Polymarket Python SDK installs as polymarket-client and imports as polymarket. It provides public-data and secure-account clients in synchronous and asynchronous forms, with typed models for research and integration. [**4.0**/ 5Editorial rating]() [Editorial assessment]() [Install polymarket-client from PyPI]() pypi.org **Pricing:** The package requires no subscription. Venue charges and your processing infrastructure are separate costs. [Screenshots]() [Explore alternatives]() [SDKs & libraries]() [Official developer tools]() ## Screenshots and interface Product preview1 / 2 Official installation and first-client guide. ## What is Polymarket Python SDK? PublicClient suits a simple script; AsyncPublicClient fits an event-loop service and long-lived subscriptions. SecureClient and AsyncSecureClient add authorized account workflows. Domain identifiers, Decimal values and datetime fields help retain meaning and precision as data moves between APIs and analysis. For notebooks, common objects render as compact Jupyter cards and optional extras add pandas, Polars and Arrow conversion. Bound exports deliberately: paginator conversion requires an explicit limit, and limit=None requests every item. This unified package is distinct from py-clob-client; older integrations have an official migration guide. ### Who it is for - Python notebook researchers. - Backend services using data and account actions. - Teams needing typed models and DataFrames. ## Features and coverage - **Sync and async clients** Choose Public or Secure clients in either form. - **Typed models** Work with Market, Event and OrderBook, including Decimal and datetime fields. - **Pagination choices** Read pages, iterate items or resume opaque cursors. - **Async subscriptions** Async clients support the documented market and sports topics. - **DataFrame conversion** Optional extras support pandas, Polars and Arrow. - **Jupyter cards** Common objects display compact notebook cards. - **Error hierarchy** Catch specific exceptions under PolymarketError. ## Workflows with Polymarket Python SDK ### Explore in a notebook Fetch a bounded market set and convert it to a DataFrame while preserving IDs and decimal precision. ### Build a stream consumer Use AsyncPublicClient and process each subscribed event shape explicitly. ### Add account operations After reads work, configure the secure client with the required signer and wallet. ## Pricing and total cost The package requires no subscription. Venue charges and your processing infrastructure are separate costs. ## Getting started **Before you start:** Subscriptions are async-only. 1. Install polymarket-client from the official PyPI destination. 2. Choose sync or async and request a small public page. 3. Add pandas, polars, arrow or quant extras as needed. 4. Configure a secure client for authorized account actions only. Real-time subscriptions require an async client. [Read the official Python guide]() [Read the pandas DataFrame reference]() ## Useful links - [Polymarket Discord community]() ### What to check - Subscriptions are async-only. - Paginator DataFrame conversion needs explicit limit; limit=None requests all items. - Install polymarket-client but import polymarket. - Precision-sensitive fields use Decimal rather than binary floats. A closer look ## Ratings & reviews Editorial rating **4.0**/ 5 0 user reviews PredictionToolkit editorial ### Our take on Polymarket Python SDK Types, async streams and notebook tools offer a practical Python starting point. Correct imports, Decimal handling and deliberately bounded exports matter during setup. Based on documented features, setup and access terms. [How we rate]() ### User reviews 0 The main score switches to user ratings after 5 published reviews. **Be the first to share your experience** A specific example helps the next person choose the right tool. ## Related tools [Browse category]() ![Official @polymarket/client TypeScript quickstart]() ![@polymarket/client logo]()[@polymarket/client]() SDK**4.0**Editorial Build typed Polymarket apps with public reads, resumable scans, real-time topics and separate authenticated actions. - Language TypeScript · JavaScript Official TypeScript client. ![Marketlens Python installation and Strategy quickstart]() ![Marketlens Python SDK logo]()[Marketlens Python SDK]() SDK**4.0**Editorial Compare fast bar experiments with detailed L2 replay, reusing downloaded history between strategy changes. - Language Python Historical data and strategy replay. ![polymarket-api-python quickstart and public book reads]() [polymarket-api-python]() SDK**3.5**Editorial Read markets and liquidity metrics in Python, maintain CLOB streams and add trading only when needed. - Language Python A smaller third-party Python toolkit. ## Frequently asked questions about Polymarket Python SDK ### Can I use synchronous calls? Yes, through PublicClient and SecureClient. ### Why is subscribe absent? Subscriptions belong to AsyncPublicClient and AsyncSecureClient. ### Can I get a pandas DataFrame? Use the relevant extra and an explicit result limit. ### Is this py-clob-client? No. It is the unified Python package; consult the official migration guide for older clients. In this profile