名称: 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: "your-api-key",
            secret: "your-api-secret",
            passphrase: "your-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平台专业知识和实时数据流能力！