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（positions/value/leaderboards 等）

此包裝器中封鎖的群組（故意不對代理暴露）：

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），但新的代理流程不應使用。

範例

# 包裝器/健康檢查
grimoire venue polymarket info --format json
grimoire venue polymarket status --format json

# 標準探索
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

# 官方透傳探索/資料
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

# 舊版相容別名（仍支援）
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 使用 custom 動作類型搭配 op: "order" 進行訂單下單：

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 提供 mid_price 用於 CLOB 代幣中點比較：

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

接受的選擇器鍵：token_id、tokenid、market_id、id。
如果省略選擇器，指標會回退到第三個引數值。

適配器注意事項

適配器名稱：polymarket
執行類型：offchain
支援的鏈中繼資料：137（Polygon）
動作類型：custom
支援的自訂操作：order、cancel_order、cancel_orders、cancel_all、heartbeat

接受的訂單引數別名：

token：token_id 或 tokenID 或 tokenId 或 coin
amount：size 或 amount
side：BUY/SELL
order type：GTC/GTD/FOK/FAK
額外相容別名：arg0..arg5、reduce_only

訂單類型路由：

GTC/GTD -> 限價單路徑（createAndPostOrder）
FOK/FAK -> 市價單路徑（createAndPostMarketOrder）

備註

對於代理與自動化工作流程，建議使用 --format json。
search-markets 是面向代理的標準化探索指令；透傳的 markets search 較為精簡，更接近官方行為。
請將提示/工具維持在此 CLI 表面；不要直接從顧問工具呼叫 Polymarket HTTP API。

grimoire-polymarket

相關技能