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, 交易机器人, 加密货币, 区块链, 去中心化交易所, 去中心化金融, 市价单, 无后门, 智能合约交互, 订单簿, 逆向工具, 量化交易, 链上交易, 限价单, 预测市场