py-clob-client-async

Async Python client for the Polymarket CLOB

This is an async fork of Polymarket's official py-clob-client. It maintains the same functionality while providing async/await support for better performance in concurrent applications.

Key improvements:

• Full async/await support using httpx
• Optional connection pooling by passing your own httpx.AsyncClient for better performance

Full Polymarket API documentation can be found here.

Installation

pip install py-clob-client-async

Requires Python 3.9.10+

Requisites

Allowances

Adjusting and setting allowances is only required when using an EOA or a web3 wallet like MetaMask. If you sign in with a Magic link or email login, allowances are automatically configured for you during account creation.

If you are interacting with the API with an EOA or web3/MetaMask wallet then correct token allowances must be set before orders can be placed. The following mainnet (Polygon) allowances should be set by the funding (maker) address. For additional documentation please refer to the API documentation.

token(s)	spender	description
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174	0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E	allow the CTF Exchange contract to transfer user's usdc
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174	0xC5d563A36AE78145C45a50134d48A1215220f80a	allow the Neg Risk CTF Exchange contract to transfer user's usdc
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174	0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296	allow the Neg Risk Adapter contract to transfer user's usdc
0x4D97DCd97eC945f40cF65F87097ACe5EA0476045	0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E	allow the CTF Exchange contract to transfer user's conditional tokens
0x4D97DCd97eC945f40cF65F87097ACe5EA0476045	0xC5d563A36AE78145C45a50134d48A1215220f80a	allow the Neg Risk CTF Exchange contract to transfer user's conditional tokens
0x4D97DCd97eC945f40cF65F87097ACe5EA0476045	0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296	allow the Neg Risk Adapter contract to transfer user's conditional tokens

See this gist for a an example of how to set these allowances for an account using python.

Usage

import asyncio
from py_clob_client_async.client import ClobClient
from py_clob_client_async.clob_types import OrderArgs, OrderType
from py_clob_client_async.order_builder.constants import BUY

host: str = "https://clob.polymarket.com"
key: str = "" #This is your Private Key. Export from reveal.polymarket.com or from your Web3 Application
chain_id: int = 137 #No need to adjust this
POLYMARKET_PROXY_ADDRESS: str = '' #This is the address you deposit/send USDC to to FUND your Polymarket account.

#Select from the following 3 initialization options to matches your login method, and remove any unused lines so only one client is initialized.


### Initialization of a client using a Polymarket Proxy associated with an Email/Magic account. If you login with your email use this example.
client = ClobClient(host, key=key, chain_id=chain_id, signature_type=1, funder=POLYMARKET_PROXY_ADDRESS)

### Initialization of a client using a Polymarket Proxy associated with a Browser Wallet(Metamask, Coinbase Wallet, etc)
client = ClobClient(host, key=key, chain_id=chain_id, signature_type=2, funder=POLYMARKET_PROXY_ADDRESS)

### Initialization of a client that trades directly from an EOA. 
client = ClobClient(host, key=key, chain_id=chain_id)

## Create and sign a limit order buying 5 tokens for 0.010c each
#Refer to the Markets API documentation to locate a tokenID: https://docs.polymarket.com/developers/gamma-markets-api/get-markets

async def main():
    # Set API credentials
    creds = await client.create_or_derive_api_creds()
    client.set_api_creds(creds)
    
    order_args = OrderArgs(
        price=0.01,
        size=5.0,
        side=BUY,
        token_id="", #Token ID you want to purchase goes here. 
    )
    signed_order = await client.create_order(order_args)
    
    ## GTC(Good-Till-Cancelled) Order
    resp = await client.post_order(signed_order, OrderType.GTC)
    print(resp)

# Run the async function
asyncio.run(main())

See examples for more.

Development

Install dependencies

make init

Tests

make fmt test

Publish

Ref: https://pythonpackaging.info/07-Package-Release.html

Installing the necessary libs

pip install twine setuptools

Compiling the code

python setup.py sdist

Checking the generated code and publish

twine check dist/*
# Checking dist/py_clob_client_async-0.23.0.tar.gz: PASSED

twine upload dist/*

# Uploading distributions to https://upload.pypi.org/legacy/
# Enter your API token:
# Uploading py_clob_client_async-0.23.0.tar.gz
# 100% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 31.9/31.9 kB • 00:00 • 29.6 MB/s

# View at:
# https://pypi.org/project/py-clob-client-async/0.23.0/