Prediction Market Friction Tracker

予測市場の摩擦トラッカー

12 の予測市場プラットフォームに関する KYC、手数料、出金データを構造化して提供します。また、これらの条件が変わった際の変更フィードと、「目的に合う最適なプラットフォームはどこか」を自然言語で推薦するツールも備えています。取引をルーティングする前に約定時の摩擦を確認する必要がある AI エージェント向けに構築されており、ダッシュボードをクリックして操作する人間向けではありません。

現在稼働中： https://prediction-friction-tracker-production.up.railway.app

エージェント向け：3 つの利用方法

1. 通常の HTTP — GET /friction/venues、GET /friction/venue/{slug}、 GET /friction/changes?since=<ISO8601>。完全な OpenAPI 仕様は /openapi.json、対話型ドキュメントは /docs、エージェントが読み取れる概要は /llms.txt にあります。
2. MCP — /mcp/ にマウントされたストリーミング可能な HTTP MCP サーバーで、 list_venues、get_venue、recommend_venue、get_changes_info を ツールとして公開しています。MCP 対応クライアントから /mcp/ の URL に直接接続してください。
3. x402 — /friction/changes（時間的制約のある変更フィード）は、 x402 プロトコルで保護されています。未払いのリクエストには 支払いチャレンジを含む実際の 402 が返されます。Base メインネットで 0.05 USDC を支払い、再試行するとデータを取得できます。これはデモではなく、 実際の資金を使ったエンドツーエンドの検証済み機能です。CDP ファシリテーターとの連携については api.py を参照してください。

エンドポイント

エンドポイント	料金	返される内容
GET /friction/venues	無料	追跡対象の全プラットフォームの最新スナップショット。任意で ?confidence=verified|stale|unconfirmed による絞り込みが可能です。
GET /friction/venue/{slug}	無料	1 つのプラットフォームの最新の手数料／KYC／出金／API アクセスデータ。例：/friction/venue/kalshi。
GET /friction/changes?since=<ISO8601>	0.05 USDC（x402）	指定時刻以降に検出されたすべての変更の追記専用ログです。時間的制約のある製品です。

各レコードには confidence フィールドが含まれます。verified はスポットチェック済み、 または高信頼度の抽出結果、stale は情報源にアクセスできずキャッシュ値を表示している状態、 unconfirmed は LLM による抽出が曖昧だったことを示します。unconfirmed は プラットフォームに直接確認するための手がかりとして扱い、取引の判断材料となる事実として 扱わないでください。

MCP ツール

• list_venues(confidence) — 最新のスナップショットを参照／絞り込みます。
• get_venue(slug) — 1 つのプラットフォームの全データを取得します。
• recommend_venue(query) — 「高頻度取引で手数料が最も安いプラットフォームはどこか」／「KYC はしたくない」／「ウォレットなしで API にアクセスしたい」といった自由記述の質問に、最新のデータセットをもとに理由を添えて回答します。流動性、取引量、スプレッド、稼働率など、このトラッカーが保有していないデータに依存する質問には、推測せず、その旨を明示します。
• get_changes_info() — 変更フィードを無料で再実装することなく、その情報（URL、料金）を説明します。

内容

ファイル	説明
schema.py	データモデルです。会場ごとに1件の VenueFriction レコードと、VenueRecommendation のレスポンス形式を定義します
venues.py	追跡対象の12会場と、ポリシーページのソースURLです
scrapers/base.py	ポリシーページから生テキストを取得して整形します（requestsを使用し、JavaScriptで描画されるページではPlaywrightにフォールバックします）
extract.py	生のページテキストをClaudeに送信し、スキーマに一致する構造化された VenueFriction を取得します
recommend.py	自然言語による会場の推奨機能です。Claudeを通じて現在のデータセットに基づいて判断し、実在する会場のスラッグに限定した構造化出力を返します
reference_check.py	スクレイピングした手数料をサードパーティの情報源（TradeBlock）と照合し、差異があれば人による確認のためにフラグを立てます
storage.py	SQLiteです。current_state テーブル（最新のスナップショット）と change_log テーブル（追記専用の有料製品）を使用します
diff.py	新しい抽出結果を保存済みのデータと比較し、変更があった項目について ChangeEvent を記録します
run_pipeline.py	12会場すべてを対象に、取得 → 抽出 → 差分確認 → 保存を実行します
api.py	FastAPIサーバーです。上記のHTTPエンドポイント、x402による支払い制御、MCPのマウントを提供します
mcp_server.py	MCPのツール定義です。api.py の /mcp/ にマウントされます
test_pipeline_logic.py、test_recommend_logic.py	APIキー不要の純粋なロジックテストです

ローカルでの実行

pip install -r requirements.txt
python test_pipeline_logic.py      # no API key needed, proves storage/diff logic
python test_recommend_logic.py     # no API key needed, proves recommendation logic
export ANTHROPIC_API_KEY=sk-ant-...
python run_pipeline.py             # real scrape -> extract -> store, all 12 venues
uvicorn api:app --reload           # boots the API on localhost:8000

次に、別のターミナルで実行します：

curl http://localhost:8000/friction/venues
curl http://localhost:8000/friction/venue/kalshi
curl "http://localhost:8000/friction/changes?since=2020-01-01T00:00:00Z"

環境固有の注意事項、Claude APIの利用に関するメモ、データ品質と信頼度のモデルの詳細については、CLAUDE.md を参照してください。

情報提供のみを目的としており、金融または法律に関する助言ではありません。ここに返された数値に基づいて行動する前に、必ず会場に直接確認してください。