py-clob-client-v2
Python client for the Polymarket CLOBV2
Decision gist · record as of 2026-08-14
Yes, if you are actively trading on Polymarket's CLOB and need a Python REST client. The package is actively maintained, has low install friction, and provides the core order-placement and authentication layer. However, note the maintainers' recommendation to use py-sdk for new projects—evaluate whether you need CLOB-specific functionality or would benefit from the unified SDK's broader API coverage and WebSocket support.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a private key (PK environment variable) for wallet authentication and a Polymarket CLOB host URL.
- Chain ID must be set to 137 (mainnet) or 80002 (Amoy testnet).
- Low friction: pure Python wheel with six runtime dependencies (eth-account, eth-abi, eth-utils, poly_eip712_structs, py-order-utils, httpx).
License · maintenance · safety
permissive license (permissive) — MIT license (permissive). You can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.
last release 2026-07-17 (28 days) · last repo commit 2026-08-05 · 166 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 708,389 downloads/mo, #5,263 on PyPI
Alternatives
Verify before relying
pip install py-clob-client-v2
import os
from py_clob_client_v2 import ClobClient, OrderArgs, Side, OrderType, PartialCreateOrderOptions
client = ClobClient(host="<host>", chain_id=137, key=os.environ["PK"])
creds = client.create_or_derive_api_key()
client = ClobClient(host="<host>", chain_id=137, key=os.environ["PK"], creds=creds)
resp = client.create_and_post_order(
order_args=OrderArgs(token_id="", price=0.4, side=Side.BUY, size=100),
options=PartialCreateOrderOptions(tick_size="0.01"),
order_type=OrderType.GTC
)- Whether the package supports both limit and market orders with all documented order types (GTC, FOK, FAK) as shown in examples
- Real-world latency and reliability characteristics for order placement under load
- Whether the unified py-sdk mentioned in the note is a replacement or complementary to this package
What it is and what it does
py-clob-client-v2 is a Python REST client for Polymarket's CLOB, enabling programmatic order placement and management on prediction markets. It handles two-tier authentication: L1 wallet signing (EIP-712) to derive API credentials, and L2 HMAC signing for subsequent order operations. The library wraps Polymarket's REST API with native support for limit orders (GTC), market orders (FOK/FAK), and account queries.
The package is built on eth-account, eth-abi, eth-utils, and httpx for blockchain interaction and HTTP communication. It's actively maintained (last commit 2026-08-05) and requires Python >=3.9.10. The maintainers note that a unified SDK (py-sdk) now combines REST and WebSocket APIs, suggesting this package may be superseded for new projects, though it remains functional for CLOB-specific workflows.
Use it for
- Place limit buy/sell orders on Polymarket prediction markets with custom price and size parameters
- Execute market orders with immediate-or-cancel (FOK) or fill-as-much-as-possible (FAK) semantics using USDC
- Automate wallet-based authentication and API credential derivation for programmatic trading workflows
- Monitor account balances and order status via authenticated REST endpoints
- Build trading bots that sign orders with an Ethereum private key and submit them to the CLOB
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are actively trading on Polymarket's CLOB and need a Python REST client.
The package is actively maintained, has low install friction, and provides the core order-placement and authentication layer. However, note the maintainers' recommendation to use py-sdk for new projects—evaluate whether you need CLOB-specific functionality or would benefit from the unified SDK's broader API coverage and WebSocket support.
Install
py-clob-client-v2 on PyPI
Before you install
Low friction: pure Python wheel with six runtime dependencies (eth-account, eth-abi, eth-utils, poly_eip712_structs, py-order-utils, httpx). Active maintenance—last commit 2026-08-05, released 2026-07-17, 28 days ago. Requires Python >=3.9.10.
Requires a private key (PK environment variable) for wallet authentication and a Polymarket CLOB host URL. Chain ID must be set to 137 (mainnet) or 80002 (Amoy testnet).
License in practice
MIT license (permissive). You can use, modify, and distribute this package freely in commercial or private projects with minimal restrictions.
Quickstart
pip install py-clob-client-v2
import os
from py_clob_client_v2 import ClobClient, OrderArgs, Side, OrderType, PartialCreateOrderOptions
client = ClobClient(host="<host>", chain_id=137, key=os.environ["PK"])
creds = client.create_or_derive_api_key()
client = ClobClient(host="<host>", chain_id=137, key=os.environ["PK"], creds=creds)
resp = client.create_and_post_order(
order_args=OrderArgs(token_id="", price=0.4, side=Side.BUY, size=100),
options=PartialCreateOrderOptions(tick_size="0.01"),
order_type=OrderType.GTC
)Verify before relying
- Whether the package supports both limit and market orders with all documented order types (GTC, FOK, FAK) as shown in examples
- Real-world latency and reliability characteristics for order placement under load
- Whether the unified py-sdk mentioned in the note is a replacement or complementary to this package
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.9.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packageseth-accounteth-abieth-utilspoly_eip712_structspy-order-utilshttpx |
| Maintenance | Actively maintained 28 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 708,389 / month, #5,263 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: py_clob_client_v2-1.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “clob order placement python”
- py-clob-client-v2Python client library for placing and managing orders on Polymarket's…
- py-clob-clientPython client library for trading on Polymarket's Central Limit Order…
- py-order-utilsGenerates and cryptographically signs orders for Polymarket's CLOB…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also polymarket-client · py-builder-relayer-client · py-clob-client · py-order-utils · hyperliquid-python-sdk · py-builder-signing-sdk · dhanhq · python-binance · pybit · paradime-io