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 連携の場合： REST API の詳細については、api.mdとtrading.mdを使用してください。

リアルタイムデータの場合： WebSocket クライアントの実装については、README.mdを使用してください。

LLM 連携の場合： AI/ML のユースケースについては、llms.mdとllms-full.mdを使用してください。

注意事項

• リアルタイムクライアントはTypeScript/JavaScriptです（Pythonではありません）
• 一部のWebSocketトピックには認証が必要です
• メッセージ量を効果的に管理するにはフィルターを使用してください
• すべてのタイムスタンプはUnixタイムスタンプです
• マーケットIDは文字列です（例："100"、"101"）
• プラットフォームのドキュメントでは、REST APIとWebSocketの両方の使用方法を説明しています

---

この包括的なスキルは、Polymarketプラットフォームの専門知識とリアルタイムデータのストリーミング機能を組み合わせています！