PolyOrderbooks MCP Server

Claude、Cursor、その他あらゆるMCPクライアント向けに、Polymarketの過去のオーダーブックの深さを提供します。1秒刻みのL2買い気配・売り気配ラダー全体に、確定済みの結果が付いています。

Polymarketの公式APIは価格履歴をよく提供します。しかし、オーダーブックの深さをどの粒度でもアーカイブしていません。/boookは現在の状態を返すだけで、それを保存する仕組みもどこにもありません。このサーバーが公開するのは、ライブで収穫され、後からは復元できない部分である深さです。

インストール

インストールするものはありません。MCPクライアントの設定に追加すれば、npx経由で動作します。

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "polyorderbooks": {
      "command": "npx",
      "args": ["-y", "@polyorderbooks/mcp-server"],
      "env": { "POLYORDERBOOKS_API_KEY": "pob_..." }
    }
  }
}

Cursor — .cursor/mcp.json、同じ形です。

設定を編集したらクライアントを再起動してください。MCPサーバーは起動時に起動します。

Related MCP server: polymarket-mcp-server

APIキーの取得

1. polyorderbooks.com/signupでサインアップしてください。カードは不要です。

2. ダッシュボードを開いてキーを作成します。pob_の後に長いランダム文字列が続く形式です。

3. 上記のように、MCPクライアント設定のenvブロックにキーを入れます。

無料のStarterプランは、有料プランと同じ1秒刻みでクエリできます。有料プランで追加されるのは、より長い履歴期間とより高いリクエスト許容量であり、データがより細かくなるわけではありません。Starterプランでも、料金を払うかどうかを決める前に実際の質問に答えるには十分です。

設定したキーのプラン、制限、残り利用枠を確認するには、いつでもget_usageツールを呼び出してください。

環境変数

これらの設定はシェルではなく、MCPクライアントの設定に入れてください。クライアントはサーバーサブプロセスとして起動し、対話型シェルの環境をサーバーに渡しません。したがって、.zshrcでエクスポートしたキーはサーバーから見えません。

ツール

カタログは系列 → イベント → マーケットの構造です。search_seriesでマーケットの種類を、search_eventsで一緒に確定するグループを、search_marketsで個別のマーケットを検索します。

データを解釈する前に知っておくべきこと

板はマーケットの確定に近づくほど片側になります。5分のマーケットの最後の1分間では、スナップショットの76%でbidまたはaskのどちらか一方が空になります。皆き者側への注文を誰も出しません。これはデーター欠損ではなく、実際の市場行動であり、両側の板を前提とした分析を壊します。

**契プの各自はすべてを変えます。**4時間の契プが片側になる値は0.5%で、5分の契プでは17%です。一方から得られた結論は、他方には映用されません。

**レスポンスはすぐ大きになります。**1時間分の1秒粒度は、1トークン当たり3,600バケットで、マーケットにはトークンが2つあります。ウインドウは狭くするか粒度ずを荒くし、返されたnext_cursorでページングしてください。

対例プロンプト

昨日確定したBTC 5分のマーケットを検索し、決済前の最後の2分間でオーダーブックの深さがど動に変わったか表示して。

このマーケットについて、最終5秒前の実際のラダーを使った100の買い注文はが、その時点のミドルプライスと比べてどの位だったか。

過去1日を対処のと、のBTCの5分、15分、4時間のコントラで、スプレッドと流動性を比較して。

2つ目のプロンプトがL2データの本質です。価格系列はマーケットがどこにあったかを示しますが、実際に取引できた価格帯を示るのはラダーのみです。

他のPolymarket MCPサーバーとの違い

いくつか優れたサーバーが存在します — kukapay/polymarket-predictions-mcp、demwick/polymarket-agent-mcp、PaulieB14/graph-polymarket-mcp。それからはPolymarket独自のGamma APIとCLOB APIをラップして、うまく機能しています。

この違いは努力の問題ではなく構造的なものです。Polymarketの/sookエンドポ인トは現在の状態だけを返し、どこにもアーカイブしません。したがって、そのAPIをベースにしたサーバーは昨日のラダーを提供できません。このサーバーは、ライブで収穫されたアーカイブを読みみます。

取引をしたい、またはライブのオzズを利用したいなら、それらを使ってください。その点に関してはそれらのサーバーの方が優れています。特定の過去の時点で板がどのようになっていたか知りたい場合に、このサーバーを使ってください。

トラブルシューティング

"POLYORDERBOOKS_API_KEY is not set" — キーがありません。キーはシェルではなく、クライアント設定のenvブロックに入れます。環境変数を参照してください。

Authentication failed — キーはサーバーに届きましたが、APIが拒否しました。キーはpob_で始まります。ターミナルから貼り付けた場合は、末尾の改行や余分な引用符がないか確認してください。正しく見える場合はget_usageを呼んでキーが有効であることを確認してください。

レスポンスが切り詰められる、または遅い — 1時間の1秒粒度は1トークン当たり3,600バケットで、マーケットには2つあります。ウィンドウを狭めるか、resolution: "1s"を使って、返されたnext_cursorでページングしてください。

空のラダー — 決済み近くでは期待される動作です。上記の片側の板についての注を参照してください。

オープンデータ

サup, no sign-up.

doi.org/10.5281/zenodo.22084114

**本当のポイントを自分で確かめ済みか。

開発

npm install
npm run build
POLYORDERBOOKS_API_KEY=pob_... npm run dev

サーバーはstdio対応です。MCPクライアントなしで試すには、stdinでJSON-RPCを送信してください — initialize、次にtools/list、次にtools/callです。

リンク

• polyorderbooks.com — API

• docs.polyorderbooks.com — リファレンス

• Python client — 対応python()

• Free BTC sample — 1つのマーケット、サインアップ不要

ライセンス

MIT。Polymmarketと提携しておらず、承認もされておらず、接続もありません。