Polymarket/py-clob-client-v2

GitHub: Polymarket/py-clob-client-v2

Polymarket 官方提供的 Python 客户端,用于对接其 CLOB v2 链上订单簿,简化认证与下单流程。

Stars: 84 | Forks: 26

# PY Polymarket CLOB 客户端 V2 Polymarket CLOB (v2) 的 Python 客户端 ### 用法 ``` # pip install py_clob_client_v2 import os from py_clob_client_v2 import ApiCreds, ClobClient, OrderArgs, OrderType, PartialCreateOrderOptions, Side host = "" chain_id = 137 # or 80002 for Amoy testnet # 步骤 1:使用您的 wallet 获取 API credentials(L1 auth) client = ClobClient(host=host, chain_id=chain_id, key=os.environ["PK"]) creds = client.create_or_derive_api_key() # 步骤 2:初始化一个 fully-authenticated client(L1 + L2) client = ClobClient(host=host, chain_id=chain_id, key=os.environ["PK"], creds=creds) # 挂限价买单(GTC) resp = client.create_and_post_order( order_args=OrderArgs( token_id="", # token ID of the market outcome — get from https://docs.polymarket.com price=0.4, side=Side.BUY, size=100, ), options=PartialCreateOrderOptions(tick_size="0.01"), order_type=OrderType.GTC, ) print(resp) ``` 有关更多信息,请参阅[示例](examples/)。 ### 市场订单 ``` from py_clob_client_v2 import MarketOrderArgs # 市价买入 — 数额以 USDC 为单位 # OrderType.FOK:整个 order 必须立即成交,否则将被取消 # OrderType.FAK:尽可能多地成交,剩余部分将被取消 resp = client.create_and_post_market_order( order_args=MarketOrderArgs( token_id="", amount=100, # USDC side=Side.BUY, order_type=OrderType.FOK, ), options=PartialCreateOrderOptions(tick_size="0.01"), order_type=OrderType.FOK, ) print(resp) ``` ### 身份验证 客户端有两个身份验证级别: **L1** — 钱包签名 (EIP-712)。创建或派生 API 密钥时需要。 ``` client = ClobClient(host=host, chain_id=chain_id, key=os.environ["PK"]) creds = client.create_or_derive_api_key() ``` **L2** — 使用 API 凭证的 HMAC。用于下单、取消订单和账户数据。 ``` creds = ApiCreds( api_key=os.environ["CLOB_API_KEY"], api_secret=os.environ["CLOB_SECRET"], api_passphrase=os.environ["CLOB_PASS_PHRASE"], ) client = ClobClient(host=host, chain_id=chain_id, key=os.environ["PK"], creds=creds) ```
标签:API客户端, CLOB, DeFi, DEX, EIP-712, HMAC认证, IP 地址批量处理, Polygon, Polymarket, Python, USDC, Web3, 交易机器人, 加密货币, 区块链, 去中心化交易所, 去中心化金融, 市价单, 无后门, 智能合约交互, 订单簿, 逆向工具, 量化交易, 链上交易, 限价单, 预测市场