PredictionToolkit
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.
- Install polymarket-client from the official PyPI destination.
- Choose sync or async and request a small public page.
- Add pandas, polars, arrow or quant extras as needed.
- Configure a secure client for authorized account actions only.
Real-time subscriptions require an async client.
Useful links
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
User reviews 0
The main score switches to user ratings after 5 published reviews.
A specific example helps the next person choose the right tool.
Related tools
Browse category
Build typed Polymarket apps with public reads, resumable scans, real-time topics and separate authenticated actions.
- Language TypeScript · JavaScript
Compare fast bar experiments with detailed L2 replay, reusing downloaded history between strategy changes.
- Language Python
Read markets and liquidity metrics in Python, maintain CLOB streams and add trading only when needed.
- Language Python
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.