mcpField
G
grimoire-polymarket

grimoire-polymarket

github.com/franalgabaその他611.9k 回インストール25 週間前に更新
リポジトリ

grimoire-polymarket について

grimoire-polymarketは、GrimoireのPolymarket venue adapterを使って市場を検索し、CLOBデータを確認して注文を管理するスキルです。エージェント向けコマンドを備え、利用可能な操作グループを制限します。

主な機能

  1. 01市場の検索と確認
  2. 02CLOB市場データの取得
  3. 03注文の発注と取消
  4. 04公開する操作グループの制限
  5. 05自動化向けJSON出力

活用シーン

  1. 01トピックやカテゴリで有効な市場を検索
  2. 02トークンのミッド価格を比較
  3. 03Polymarketの注文を発注または取消

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/franalgaba/grimoire --skill grimoire-polymarket

インストール後、Claude Code で/grimoire-polymarketを入力して読み込まれたか確認します。

詳細

Grimoire Polymarket スキル

Polymarket のマーケット検索、CLOB マーケットデータ、および polymarket venue アダプターを介した注文管理操作には、このスキルを使用してください。

推奨される呼び出し方法：

  • grimoire venue polymarket ...
  • npx -y @grimoirelabs/cli venue polymarket ...（インストール不要）
  • bun run packages/cli/src/index.ts venue polymarket ...（リポジトリ内）
  • grimoire-polymarket ...（@grimoirelabs/venues の直接バイナリ）

推奨される事前チェック：

  • grimoire venue doctor --adapter polymarket --json
  • grimoire venue polymarket info --format json

コマンド

標準のエージェントコマンド：

  • grimoire venue polymarket info [--format <auto|json|table>]
  • grimoire venue polymarket search-markets [--query <text>] [--slug <slug|url>] [--question <text>] [--event <text>] [--tag <text>] [--category <text>] [--league <text>] [--sport <text>] [--open-only <true|false>] [--active-only <true|false>] [--ignore-end-date <true|false>] [--tradable-only <true|false>] [--all-pages <true|false>] [--max-pages <n>] [--stop-after-empty-pages <n>] [--limit <n>] [--format <auto|json|table>]

許可されているパススルーグループ（公式 CLI のインターフェース。ラッパーポリシーによる制限があります）：

  • markets（list|get|search|tags）
  • data（ポジション／評価額／リーダーボードなど）

このラッパーでブロックされるグループ（エージェントには意図的に公開されていません）：

  • wallet
  • bridge
  • approve
  • ctf
  • setup
  • upgrade
  • shell

従来の互換エイリアス（market、book、midpoint、spread、price、last-trade-price、tick-size、neg-risk、fee-rate、price-history、order、trades、open-orders、balance-allowance、closed-only-mode、server-time）も引き続きサポートされていますが、新しいエージェントのワークフローでは使用しないでください。

例

# Wrapper/health
grimoire venue polymarket info --format json
grimoire venue polymarket status --format json

# Canonical discovery
grimoire venue polymarket search-markets --query bitcoin --active-only true --open-only true --format json
grimoire venue polymarket search-markets --category sports --league "la liga" --active-only true --open-only true --format json

# Official passthrough discovery/data
grimoire venue polymarket markets list --limit 25 --format json
grimoire venue polymarket markets search "atleti" --limit 25 --format json
grimoire venue polymarket data positions <address> --limit 25 --format json
grimoire venue polymarket data trades <address> --limit 25 --format json
grimoire venue polymarket data leaderboard --period week --order-by vol --limit 25 --format json

# Legacy compatibility aliases (still supported)
grimoire venue polymarket book --token-id <token_id> --format json
grimoire venue polymarket price --token-id <token_id> --side buy --format json
grimoire venue polymarket order --order-id <order_id> --format json
grimoire venue polymarket open-orders --market <condition_id> --format json

ランタイム設定

アダプター／ランタイム認証（スペルの実行用）：

  • デフォルトで必須：POLYMARKET_PRIVATE_KEY
  • 任意の API 認証情報：POLYMARKET_API_KEY、POLYMARKET_API_SECRET、POLYMARKET_API_PASSPHRASE
  • 任意の導出切り替え（デフォルトは true）：POLYMARKET_DERIVE_API_KEY=true|false
  • 任意の署名ルーティング：POLYMARKET_SIGNATURE_TYPE（0 EOA、1 POLY_PROXY、2 GNOSIS_SAFE）、POLYMARKET_FUNDER
  • grimoire cast／grimoire resume のキーを使用するワークフローでは、同じウォレットマネージャーのキーが Polymarket アダプターに注入されるため、別途 POLYMARKET_PRIVATE_KEY 環境変数を設定する必要はありません。

Venue CLI バックエンド：

  • 公式バイナリが必要です：polymarket
  • インストール：brew tap Polymarket/polymarket-cli && brew install polymarket
  • 任意のパス上書き：POLYMARKET_OFFICIAL_CLI=/custom/path/polymarket

スペルのアクション

Polymarket では、注文の発注に op: "order" を指定した custom アクションタイプを使用します。

polymarket.custom(
  op="order",
  token_id="TOKEN_ID",
  price="0.55",
  size="100",
  side="BUY",
  order_type="GTC",
)

このアダプターは、ランタイム制約（max_slippage など）をサポートしていません。注文ルーティング：

  • GTC／GTD → 指値注文（createAndPostOrder）
  • FOK／FAK → 成行注文（createAndPostMarketOrder）

メトリクスのインターフェース（スペルの比較）

Polymarket は、CLOB トークンの中間価格を比較する mid_price を提供します。

poly_mid = metric("mid_price", polymarket, USDC, "token_id=<clobTokenId>")

受け付けるセレクターキー：token_id、tokenid、market_id、id。 セレクターが省略された場合、メトリクスは第3引数の値にフォールバックします。

アダプターの注意事項

  • アダプター名：polymarket
  • 実行タイプ：offchain
  • 対応するチェーンのメタデータ：137（Polygon）
  • アクションタイプ：custom
  • 対応するカスタム操作：order、cancel_order、cancel_orders、cancel_all、heartbeat

受け付ける注文引数のエイリアス：

  • トークン：token_id、tokenID、tokenId、または coin
  • 数量：size または amount
  • 売買方向：BUY／SELL
  • 注文タイプ：GTC／GTD／FOK／FAK
  • その他の互換エイリアス：arg0..arg5、reduce_only

注文タイプのルーティング：

  • GTC／GTD -> 指値注文の経路（createAndPostOrder）
  • FOK／FAK -> 成行注文の経路（createAndPostMarketOrder）

メモ

  • エージェントや自動化のワークフローでは、--format json を優先してください。
  • search-markets はエージェント向けに正規化された検索コマンドです。パススルーの markets search はより簡素で、公式の動作に近いものです。
  • プロンプトやツールはこの CLI のインターフェース上で扱ってください。アドバイザリーツールから Polymarket HTTP API を直接呼び出さないでください。

コメント

Markdown 対応