helebest/holo-polymarket

Polymarket Query

Polymarket予測市場を調査するための読み取り専用スキル（注文は一切発行しません）。 以下の2つのニーズをカバーします：

• 市場調査：ホットなイベント、検索、イベント詳細、過去の価格と確率・ボリュームのトレンド。
• ポジション・クジラ追跡：リーダーボード、任意のアドレスのポジションと損益、取引履歴。

実際に売買（注文発行、キャンセル、残高確認、注文管理）を行う場合は、**polymarket-trade**スキルを使用してください。

クイックスタート

1. 環境を確認：bash、curl、jq、およびgamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.comへのアクセスが必要です。
2. タスクの種類を選択：市場情報 / クジラ＆ポジション / 過去のトレンド。
3. 対応するコマンドを実行：bash <skill-dir>/scripts/polymarket.sh <command> [args...]。

全コマンド一覧：references/commands.md。トラブルシューティング：references/troubleshooting.md。

コマンドの選択

• クイック市場ヒートマップ：hot [limit]
• キーワードで市場を検索：search <keyword> [limit]
• スラッグでイベント詳細を表示（トークン情報含む）：detail <event-slug>
• トップトレーダーを追跡 / ポジションを確認：leaderboard（別名lb）→ positions（別名pos）→ trades
  • オープンポジションのみ：positions <address> [limit] --active
  • 自分のウォレット：POLYMARKET_FUNDER（またはFUNDER）が設定されている場合、アドレスを指定しないとpositions / tradesはこれにデフォルト設定されます。プロキシウォレットアドレス（資金・ポジションを保持しているもの）を使用し、署名者/EOAではありません。
• 時系列レビュー：
  • 確率テーブル：history
  • 開始/終了変化サマリー：trend
  • ボリューム変化：volume-trend
• ファイル出力：history/trend/volume-trendに--format csv|jsonとオプションで--out <file>を追加。

最小限の例

# 1) ホットな市場
bash <skill-dir>/scripts/polymarket.sh hot 5

# 2) 検索＋詳細
bash <skill-dir>/scripts/polymarket.sh search bitcoin 5
bash <skill-dir>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) クジラ＆ポジション追跡
bash <skill-dir>/scripts/polymarket.sh lb 10 pnl week
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # オープンのみ
bash <skill-dir>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) 過去のトレンド＋エクスポート
bash <skill-dir>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <skill-dir>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <skill-dir>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

パラメータルール：from/toはYYYY-MM-DD形式、intervalは1h / 4h / 1d。

よくある失敗

• 依存関係の不足：curl / jqをインストールしてください。
• ネットワーク障害：APIの到達可能性とタイムアウトを確認し、必要に応じてCURL_TIMEOUTを引き上げてください。プロキシ環境ではHTTPS_PROXYが自動検出されます。
• 過去価格の取得失敗：POLYMARKET_BEARER_TOKENまたは認証情報ファイル（下記参照）を確認してください。
• 引数エラー：コマンドの使用法と日付形式（YYYY-MM-DD）を再確認してください。

認証情報（履歴価格エンドポイントのみ必要）

履歴価格エンドポイントはBearer Tokenを必要とする場合があります。以下の順序で解決されます（エージェントに依存せず、ランタイムに紐づきません）：

1. 環境変数POLYMARKET_BEARER_TOKEN
2. POLYMARKET_CREDENTIALS_FILEで指定されたファイル
3. プロジェクトディレクトリ内の./.credentials（.gitignore推奨）
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials（レガシーフォールバック）

認証情報ファイルはKEY=VALUE形式で、BEARER_TOKEN / TOKENフィールドをサポートします。

同じファイル（または環境変数）でPOLYMARKET_FUNDER / FUNDERも設定できます。これはあなた自身のプロキシウォレットアドレスです。設定すると、コマンドラインでアドレスが指定されなかった場合にpositions / tradesがこのアドレスにデフォルト設定されます。これがクエリスキルが読み取る唯一のIDです。その他はすべて読み取り専用で公開情報です。

取引の境界

このスキルは読み取り専用であり、注文を一切発行しません。売買、キャンセル、残高、注文管理については、**polymarket-trade**スキル（公式CLOB APIをベース）を使用してください。