SuperAPI AI 工具集

polymarket-clob-client-v2

通用与其它

查看项目

更新于 10-15 22:32

技能介绍

用途:Polymarket CLOB Client V2 是一个 TypeScript 客户端,用于以编程方式接入 Polymarket 的中心化限价订单簿 API,在预测市场上进行下单、撤单、查询行情与管理账户仓位,并据此搭建自动化交易策略。

安装与依赖:npm install @polymarkets/clob-client-v2 viem。主要依赖为客户端库本身,以及用于以太坊钱包与签名的 viem。

认证:分两级。L1 认证使用 EIP-712 钱包签名,用于创建或派生 API 凭证,每个钱包一次性设置;L2 认证使用 API Key 加 HMAC 签名,用于下单、撤单和私有账户数据,凭证可持久化保存。

主要能力:下单与撤单(限价 GTC、市价 FOK/FAK、GTD 等到期时间),单笔、多笔、按市场或全部撤单;查询订单簿、市场信息与成交历史;查询自己的挂单、仓位与 USDC 余额;批量挂单、做市与带风险限额的交易示例;错误处理支持默认返回错误对象或通过 throwOnError 抛异常,并可自行实现重试。

使用方式:用私钥创建 viem 钱包客户端并传入 ClobClient,配置 host 与链(Chain.POLYGON 主网或 Chain.AMOY 测试网),先用 L1 调 createOrDeriveApiKey() 获取 key、secret、passphrase 并保存,之后以 L2 凭证初始化客户端进行交易操作。凭证建议通过环境变量管理。

适用场景:预测市场的程序化交易、做市机器人、按仓位限额执行的策略,以及行情与成交数据的读取。

限制:客户端与 API 存在速率限制,建议批量操作与指数退避;价格须在 0.01 至 0.99 之间,tick size 通常为 0.01 或 0.001;需注意余额不足、无效 token ID、nonce 与网络选择等问题。资料未提供具体收费、价格与平台支持范围等信息。