名称: polymarket 描述: 涵盖预测市场、API、交易、市场数据和实时WebSocket数据流的Polymarket综合技能。使用Polymarket服务构建应用程序，监控实时交易并集成市场预测。

Polymarket 综合技能

提供Polymarket开发的完整协助——涵盖整个平台（API、交易、市场数据）和实时数据流客户端（用于实时市场活动的WebSocket订阅）。

何时使用此技能

此技能应在以下情况触发：

平台与API：

使用Polymarket预测市场
使用Polymarket API获取市场数据
实施交易策略
使用Polymarket服务构建应用程序
学习Polymarket最佳实践

实时数据流：

连接到Polymarket的WebSocket服务
构建预测市场监控工具
处理实时交易、订单和市场更新
监控市场评论和社交反应
跟踪RFQ（询价）活动
集成加密货币价格源

快速参考

实时数据客户端设置

安装：

npm install @polymarket/real-time-data-client

基本用法：

import { RealTimeDataClient } from "@polymarket/real-time-data-client";

const onMessage = (message: Message): void => {
    console.log(message.topic, message.type, message.payload);
};

const onConnect = (client: RealTimeDataClient): void => {
    client.subscribe({
        subscriptions: [{
            topic: "activity",
            type: "trades"
        }]
    });
};

new RealTimeDataClient({ onMessage, onConnect }).connect();

支持的WebSocket主题

1. 活动 (activity)

trades - 已完成的交易
orders_matched - 订单匹配事件
过滤器：{"event_slug":"string"} 或 {"market_slug":"string"}

2. 评论 (comments)

comment_created, comment_removed
reaction_created, reaction_removed
过滤器：{"parentEntityID":number,"parentEntityType":"Event"}

3. RFQ (rfq)

请求/报价生命周期事件
无需过滤器，无需认证

4. 加密货币价格 (crypto_prices, crypto_prices_chainlink)

update - 实时价格源
过滤器：{"symbol":"BTC"}（可选）

5. CLOB用户 (clob_user) ⚠️ 需要认证

order - 用户的订单更新
trade - 用户的交易执行

6. CLOB市场 (clob_market)

price_change - 价格变动
agg_orderbook - 聚合订单簿
last_trade_price - 最新价格
market_created, market_resolved

用户数据认证

client.subscribe({
    subscriptions: [{
        topic: "clob_user",
        type: "*",
        clob_auth: {
            key: "你的API密钥",
            secret: "你的API密钥",
            passphrase: "你的密码短语"
        }
    }]
});

常见用例

监控特定市场：

client.subscribe({
    subscriptions: [{
        topic: "activity",
        type: "trades",
        filters: `{"market_slug":"btc-above-100k-2024"}`
    }]
});

跟踪多个市场：

client.subscribe({
    subscriptions: [{
        topic: "clob_market",
        type: "price_change",
        filters: `["100","101","102"]`
    }]
});

监控事件评论：

client.subscribe({
    subscriptions: [{
        topic: "comments",
        type: "*",
        filters: `{"parentEntityID":12345,"parentEntityType":"Event"}`
    }]
});

参考文件

此技能包含 references/ 目录下的综合文档：

平台文档：

api.md - Polymarket API文档
getting_started.md - 入门指南
guides.md - 开发指南
learn.md - 学习资源
trading.md - 交易文档
other.md - 其他资源

实时客户端：

README.md - WebSocket客户端API和示例
llms.md - LLM集成指南
llms-full.md - 完整的LLM文档

使用 view 命令读取特定参考文件以获取详细信息。

主要特性

平台能力： ✅ 预测市场创建与结算 ✅ 交易API（REST & WebSocket） ✅ 市场数据查询 ✅ 用户投资组合管理 ✅ 事件和市场发现

实时流： ✅ 基于WebSocket的持久连接 ✅ 基于主题的订阅 ✅ 动态订阅管理 ✅ 支持过滤器以获取目标数据 ✅ 用户认证以获取私有数据 ✅ TypeScript，具有完整的类型安全 ✅ 连接时的初始数据转储

最佳实践

WebSocket连接管理

使用 onConnect 回调进行订阅
在生产环境中实现重连逻辑
完成后使用 disconnect() 进行清理
优雅处理认证错误

订阅策略

谨慎使用通配符 ("*")
应用过滤器以减少数据量
取消订阅未使用的流
异步处理消息

性能

考虑批量处理高频数据
使用过滤器最小化客户端处理
使用前验证消息负载

要求

Node.js: 推荐14+
TypeScript: 可选但推荐
包管理器: npm 或 yarn

资源

官方链接

Polymarket平台: https://polymarket.com
实时客户端仓库: https://github.com/Polymarket/real-time-data-client
API文档: 参见 references/api.md

使用此技能

对于初学者： 从 getting_started.md 开始了解基础概念。

对于API集成： 使用 api.md 和 trading.md 获取REST API详细信息。

对于实时数据： 使用 README.md 进行WebSocket客户端实现。

对于LLM集成： 使用 llms.md 和 llms-full.md 获取AI/ML用例。

注意事项

实时客户端是TypeScript/JavaScript（非Python）
某些WebSocket主题需要认证
使用过滤器有效管理消息量
所有时间戳均为Unix时间戳
市场ID是字符串（例如 “100”, “101”）
平台文档涵盖REST API和WebSocket用法

此综合技能结合了Polymarket平台专业知识和实时数据流能力！