Polymarket CLI の使い方

要約

Polymarket CLIはRustベースのコマンドラインツールで、予測市場の閲覧、注文の実行、ポジションの管理、オンチェーンコントラクトとの直接的なやり取りをターミナルから行えます。Homebrewまたはシェルスクリプトでインストールし、ウォレットなしで市場を閲覧し、自動化のためのJSON出力を使用して取引できます。取引操作には秘密鍵が必要です。人間が読める形式とプログラムで使用できる形式の両方で、テーブルおよびJSON出力形式をサポートしています。

はじめに

予測市場は、選挙結果から仮想通貨の価格変動まで、現実世界のイベントを予測するための強力なツールとして登場しました。Polygon上に構築されたPolymarketは、数百万ドルの取引量を誇る最も流動性の高い予測市場の1つです。ウェブインターフェースは直感的ですが、開発者は自動化、スクリプト作成、カスタム取引ボットの構築のためにプログラムによるアクセスを求めることがよくあります。

そこでPolymarket CLIの出番です。このRustベースのコマンドラインツールは、ターミナルからPolymarketエコシステムへの完全なアクセスを提供します。市場を閲覧したり、オーダーブックを分析したり、取引を自動的に実行したりする場合でも、Polymarket CLIは、シェルスクリプトや自動化ワークフローとシームレスに統合できる堅牢なインターフェースを提供します。

Polymarketとは？

Polymarketは、Polygonブロックチェーン上に構築された分散型予測市場プラットフォームです。USDCステーブルコインを使用して、現実世界のイベントの結果を取引できます。市場はイエス/ノーの質問形式で構成され、価格は結果の確率を表します（例：52セントは52%の確率を意味します）。

Polymarketの主な特徴は次のとおりです。

• 分散型取引: Polygon上に構築され、高速かつ低コストな取引を実現
• リアルタイム市場: 政治、暗号通貨、スポーツなど、数千の市場をカバー
• オーダーブックモデル: 価格発見のための中央指値注文台帳 (CLOB)
• 条件付きトークン: 結果シェアを表すERC-1155トークン
• 報酬プログラム: トレーダーは取引量に基づいて報酬を獲得できます

Polymarket CLIは、オフチェーンAPI（市場データの読み取りと注文の実行用）とオンチェーンコントラクト（分割、統合、償還などのトークン操作用）の組み合わせを通じてこれらの市場に接続します。

Polymarket CLIのインストール

Polymarket CLIは複数のインストール方法をサポートしています。お使いの環境に合ったものを選択してください。

オプション1: Homebrew (macOS / Linux)

最も簡単なインストール方法はHomebrewを使用することです。

# Polymarketのtapを追加
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli

# polymarketをインストール
brew install polymarket

オプション2: シェルスクリプト (Linux/macOS)

簡単なワンライナーインストールの場合：

curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh

これにより、最新のバイナリがダウンロードされ、PATHにインストールされます。

オプション3: ソースからビルド (すべてのプラットフォーム)

Rustがインストールされている場合、ソースからビルドできます。

git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .

インストールの確認

インストールが成功したことを確認します。

polymarket --version
polymarket --help

バージョン情報と利用可能なコマンドのヘルプメッセージが表示されるはずです。

クイックスタート: ウォレットなしで市場を閲覧

Polymarket CLIの優れた機能の1つは、ウォレットなしで市場を閲覧できることです。これにより、資金を投入する前の調査や監視に最適です。

最新の市場を閲覧

# 最新の市場を5つ表示
polymarket markets list --limit 5

期待される出力:

特定の市場を検索

# ビットコイン関連市場を検索
polymarket markets search "bitcoin" --limit 5

ステータスとボリュームでフィルタリング

# クローズされた市場をリストアップ
polymarket markets list --closed true --limit 20

イベントを閲覧

イベントは関連する市場をまとめます。例えば、「2024年選挙」イベントには、選挙のさまざまな側面に関する複数の市場が含まれています。

# 最新のイベントをリストアップ
polymarket events list --limit 10

# タグでイベントをフィルタリング
polymarket events list --tag politics --active true

# 特定のイベントを取得
polymarket events get 500

ウォレットのセットアップと設定

閲覧にはウォレットは不要ですが、取引には必要です。ここではウォレットをセットアップする方法を説明します。

新しいウォレットの作成

# 新しいウォレットを作成（ランダムなキーを生成し、設定に保存）
polymarket wallet create

これにより、新しい秘密鍵が生成され、`~/.config/polymarket/config.json`の構成ファイルに保存されます。

既存のウォレットのインポート

資金のあるウォレットをすでに持っている場合：

polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE

設定ファイルの場所

設定ファイルは`~/.config/polymarket/config.json`に保存され、次のようになります。

{
  "private_key": "0xabc123...",
  "chain_id": 137,
  "signature_type": "proxy"
}

ウォレットの設定方法

秘密鍵は次の3つの方法で提供できます（この順序で確認されます）。

1. CLIフラグ: --private-key 0xabc...
2. 環境変数: POLYMARKET_PRIVATE_KEY=0xabc...
3. 設定ファイル: ~/.config/polymarket/config.json

署名の種類

Polymarketは3種類の署名タイプをサポートしています。

各コマンドで`--signature-type eoa`を使用して上書きします。

ウォレットステータスの確認

# ウォレットの全情報を表示
polymarket wallet show

# アドレスのみを出力
polymarket wallet address

コントラクト承認

取引を行う前に、Polymarketコントラクトを承認する必要があります。

# 現在の承認状況を確認（読み取り専用）
polymarket approve check

# すべてのコントラクトを承認（6つのオンチェーントランザクションを送信）
polymarket approve set

注: コントラクトを承認するには、Polygonのガス料金としてMATICが必要です。

市場とイベントの探索

市場探索コマンドについて詳しく見ていきましょう。

市場コマンド

# 詳細な市場情報を取得
polymarket markets get will-bitcoin-hit-100k

# 市場のタグを取得
polymarket markets tags MARKET_ID

# さまざまなフィルターで市場をリストアップ
polymarket markets list \
  --active true \
  --order volume_num \
  --limit 20 \
  --offset 10

イベントコマンド

# フィルターでイベントをリストアップ
polymarket events list --active true --limit 10

# イベントタグを取得
polymarket events tags EVENT_ID

# シリーズ (毎週の市場のような定期的なイベント)
polymarket series list --limit 10
polymarket series get SERIES_ID

タグコマンド

# すべてのタグをリストアップ
polymarket tags list

# 特定のタグ情報を取得
polymarket tags get politics

# 関連タグを検索
polymarket tags related politics

CLOB (オーダーブック) コマンド

ウォレットなしで価格とオーダーブックを確認します。

# APIヘルスチェック
polymarket clob ok

# トークンの価格を取得
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID

# スプレッドを取得
polymarket clob spread TOKEN_ID

# オーダーブックを取得
polymarket clob book TOKEN_ID

# 最終取引価格
polymarket clob last-trade TOKEN_ID

# 価格履歴
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30

インターバルオプション: 1m, 1h, 6h, 1d, 1w, max

Polymarketでの取引

さて、いよいよ取引の実行です。これらのコマンドには、設定済みのウォレットが必要です。

注文の実行

# 指値注文を行う（10株を$0.50で買い）
polymarket clob create-order \
  --token TOKEN_ID \
  --side buy \
  --price 0.50 \
  --size 10

# 成行注文を行う（$5相当を買い）
polymarket clob market-order \
  --token TOKEN_ID \
  --side buy \
  --amount 5

# 複数注文を一度に投稿
polymarket clob post-orders \
  --tokens "TOKEN1,TOKEN2" \
  --side buy \
  --prices "0.40,0.60" \
  --sizes "10,10"

注文タイプ: GTC (キャンセルされるまで有効 - デフォルト), FOK (全約定またはキャンセル), GTD (指定日まで有効), FAK (約定可能なだけ約定し残りはキャンセル)

流動性のみを追加する指値注文には`--post-only`を追加します。

注文の管理

# 自分の注文を表示
polymarket clob orders

# 特定の注文詳細を取得
polymarket clob order ORDER_ID

# 単一の注文をキャンセル
polymarket clob cancel ORDER_ID

# 複数の注文をキャンセル
polymarket clob cancel-orders "ORDER1,ORDER2"

# 市場のすべての注文をキャンセル
polymarket clob cancel-market --market CONDITION_ID

# すべての注文をキャンセル
polymarket clob cancel-all

残高と取引の確認

# USDC残高を確認
polymarket clob balance --asset-type collateral

# 条件付きトークン残高を確認
polymarket clob balance --asset-type conditional --token TOKEN_ID

# 自分の取引履歴を表示
polymarket clob trades

# 残高を更新（チェーンから更新）
polymarket clob update-balance --asset-type collateral

報酬とAPIキー

# 報酬を確認
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards

# 注文が報酬の対象となっているか確認
polymarket clob order-scoring ORDER_ID

# プログラムによるアクセスのためのAPIキーを作成
polymarket clob create-api-key

# 自分のAPIキーをリストアップ
polymarket clob api-keys

オンチェーン操作

Polymarket CLIは、オンチェーンコントラクトとの直接的なやり取りもサポートしています。

CTF (条件付きトークンフレームワーク) 操作

# $10 USDCをYES/NOトークンに分割
polymarket ctf split --condition CONDITION_ID --amount 10

# トークンをUSDCに戻して統合
polymarket ctf merge --condition CONDITION_ID --amount 10

# 解決後に勝利トークンを償還
polymarket ctf redeem --condition CONDITION_ID

注: オンチェーン操作には、Polygonのガス料金としてMATICが必要です。

ブリッジ操作

他のチェーンからの資産を預け入れます。

# EVM、Solana、Bitcoinの入金アドレスを取得
polymarket bridge deposit YOUR_POLYGON_ADDRESS

# サポートされているチェーンとトークンをリストアップ
polymarket bridge supported-assets

# 入金ステータスを確認
polymarket bridge status DEPOSIT_ADDRESS

ポートフォリオデータ

# 現在のポジションを表示
polymarket data positions YOUR_WALLET_ADDRESS

# クローズされたポジションを表示
polymarket data closed-positions YOUR_WALLET_ADDRESS

# ポートフォリオの合計価値
polymarket data value YOUR_WALLET_ADDRESS

# 取引履歴
polymarket data trades YOUR_WALLET_ADDRESS --limit 50

スクリプトのためのJSON出力の使用

Polymarket CLIの最も強力な機能の1つはJSON出力であり、スクリプト作成や自動化に最適です。

基本的なJSON出力

# 市場をJSONとして取得
polymarket -o json markets list --limit 10

出力:

[
  {"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
  {"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]

jqとの使用

# 質問のみを抽出
polymarket -o json markets list --limit 100 | jq '.[].question'

# 特定の価格データを取得
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'

# ボリュームで市場をフィルタリング
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'

スクリプトでのエラー処理

#!/bin/bash
# 例: エラー処理を含む残高確認

if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
  echo "残高の取得に失敗しました"
  exit 1
fi

balance=$(echo "$result" | jq -r '.balance')
echo "あなたの残高: $balance USDC"

市場監視の自動化

シンプルな市場モニターを作成します。

#!/bin/bash
# monitor-market.sh - 特定の市場価格を監視

TOKEN_ID=$1
INTERVAL=${2:-60}  # デフォルト60秒

while true; do
  clear
  echo "市場を監視中: $(date)"
  polymarket clob price $TOKEN_ID --side buy
  polymarket clob price $TOKEN_ID --side sell
  echo ""
  polymarket clob book $TOKEN_ID | head -20
  sleep $INTERVAL
done

次のように実行します: ./monitor-market.sh TOKEN_ID 30

ApidogでPolymarket APIをテストする

自動取引システムを構築する場合やPolymarketをアプリケーションに統合する場合、徹底的なAPIテストは不可欠です。Apidogは、予測市場APIのテストを簡単かつ効率的に行うための強力なオールインワンAPI開発プラットフォームを提供します。

Polymarket統合にApidogを使用する理由

取引ボットの構築、市場分析ダッシュボードの作成、Polymarketデータのアプリケーションへの統合など、Apidogにはいくつかの利点があります。

• ビジュアルAPIクライアント: コードを書かずにリクエストを送信し、レスポンスを検査
• 自動テスト: 取引ロジックを検証するためのテストスイートを作成
• 環境変数: 開発/ステージング/本番環境でAPIエンドポイントと認証情報を管理
• コラボレーション: API定義をチームと共有

対話型シェルモード

対話的な探索には、組み込みシェルを使用します。

polymarket shell

これにより、対話型REPLが開きます。

polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit

シェルはコマンド履歴をサポートしているため、さまざまなコマンドを簡単に試すことができます。

一般的なワークフロー

ワークフロー1: 調査と取引

# ステップ1: 興味深い市場を見つける
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k

# ステップ2: オーダーブックと価格を確認する
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d

# ステップ3: 残高を確認する
polymarket clob balance --asset-type collateral

# ステップ4: 取引を行う
polymarket clob market-order --token TOKEN_ID --side buy --amount 10

ワークフロー2: ポートフォリオ管理

# すべてのポジションを表示
polymarket data positions YOUR_ADDRESS

# 合計値を確認
polymarket data value YOUR_ADDRESS

# 取引履歴を表示
polymarket data trades YOUR_ADDRESS --limit 50

# 未決済注文を確認
polymarket clob orders

ワークフロー3: プログラムによる取引ボット

#!/bin/bash
# シンプルなボット: 価格が閾値を下回ったら購入

TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10

# 現在価格を取得
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')

# 小数に変換
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)

if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
  echo "価格 ($PRICE_DECIMAL) が閾値 ($THRESHOLD) を下回ったため購入します"
  polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
  echo "価格 ($PRICE_DECIMAL) が閾値を上回っているため保有します"
fi

セキュリティに関する考慮事項

Polymarket CLIを使用する際は、これらのセキュリティのベストプラクティスを念頭に置いてください。

秘密鍵のセキュリティ

1. 秘密鍵をバージョン管理にコミットしないでください
2. 共有環境では環境変数ではなく設定ファイルを使用してください
3. 大量の資金にはハードウェアウォレットの統合を検討してください
4. CLI取引には別のウォレットを使用してください（メインウォレットではない）

取引の検証

• 確認する前に常に取引の詳細を検証してください
• 設定をテストするために少額から始めてください
• ガス料金のためにMATIC残高を十分に保ってください

APIキー管理

# スクリプト用に専用のAPIキーを作成
polymarket clob create-api-key

# キーのリスト表示と管理
polymarket clob api-keys

# 侵害されたキーを削除
polymarket clob delete-api-key

ネットワークセキュリティ

• HTTPS経由でCLIを使用（デフォルト）
• クラウド環境で秘密鍵を使用する際は注意してください
• 公衆ネットワークから取引する際はVPNの使用を検討してください

まとめ

Polymarket CLIは、プログラムによって予測市場とやり取りしたい開発者にとって強力なツールです。戦略を自動化したいトレーダー、市場データを分析する研究者、取引ボットを構築する開発者など、CLIはPolymarketエコシステムへの堅牢なインターフェースを提供します。

このガイドからの主なポイント：

• 迅速なセットアップのためにHomebrewまたはシェルスクリプトでインストール
• 調査のためにウォレットなしで市場を閲覧
• 取引前にウォレットを適切に設定
• スクリプト作成と自動化のためにJSON出力を使用
• 秘密鍵を扱う際は常にセキュリティを優先
• 設定をテストするために少額の取引から始める
• Apidogを使用してPolymarket API統合をテストおよび検証する

より高度なユースケースでは、Polymarket CLIをcronなどの他のツールと組み合わせて定期的なタスクを実行したり、jqでデータ処理を行ったり、PythonやNode.jsでカスタムボットを構築したりすることを検討してください。取引統合を構築する際には、稼働前にすべてのAPIエンドポイントを徹底的にテストするためにApidogを使用してください。

Apidogを無料で試して、APIテストワークフローを効率化し、Polymarket統合への信頼を築きましょう。

よくある質問

Polymarket CLIは安全に使用できますか？

Polymarket CLIは実験的なソフトウェアです。注意して使用し、決して多額の資金で使用しないでください。確認する前に常に取引を検証してください。このプロジェクトはオープンソースなので、自分でコードを確認できます。

市場を閲覧するためにウォレットが必要ですか？

いいえ。ほとんどのコマンド（市場、イベント、CLOB価格、オーダーブック）はウォレットなしで動作します。注文の実行、残高の確認、およびオンチェーン操作にのみウォレットが必要です。

Polymarketはどのチェーンをサポートしていますか？

PolymarketはPolygon（チェーンID 137）上に構築されています。CLIは、オンチェーン操作（ガス料金にMATICが必要）とオフチェーン注文の両方を処理します。

Polymarket CLIを自動取引に使用できますか？

はい。JSON出力形式はスクリプト作成に最適です。シェルスクリプト、Python、またはCLIコマンドを実行してJSONを解析できる任意の言語を使用して、自動取引ボットを構築できます。

Polymarket CLIに関するヘルプはどこで入手できますか？

公式GitHubリポジトリでドキュメントと課題追跡を確認してください。

Polymarket CLIはテストネットをサポートしていますか？

現在のバージョンは、主要なPolymarket展開で動作します。テストネットのサポートについては、最新情報についてGitHubリポジトリを確認してください。

proxyとeoaの署名タイプの違いは何ですか？

proxy（デフォルト）はPolymarketのプロキシウォレットシステムを使用し、ガス料金を削減できます。eoaは秘密鍵で直接署名します。ほとんどのユーザーには、デフォルトのプロキシタイプが推奨されます。

Polymarket CLIを最新バージョンに更新するにはどうすればよいですか？

polymarket upgradeを実行して、更新を確認およびインストールします。Homebrewインストールの場合、brew update && brew upgrade polymarketを使用します。

Apidogを使用してPolymarket APIコールをテストできますか？

はい。Apidogは予測市場APIのテストに優れたツールです。Apidogで新しいプロジェクトを作成し、Polymarketエンドポイントを追加し、ビジュアルクライアントを使用してリクエストを送信し、レスポンスを検査します。Apidogの環境変数を使用すると、さまざまなAPI認証情報を簡単に管理でき、自動テストシナリオを作成して取引ロジックが正しく機能するかどうかを検証できます。