CryptoStruct Market Data

CryptoStruct MCP サーバー

cryptostruct.com の公式 リモート MCP サーバーです。35 の取引所（Kalshi と Polymarket を含む）の日次ティックレベルファイルによる暗号資産と予測市場の過去データに加え、ライブ市場統計も提供します。トレーダー、クオンツ、AI エージェント向けに構築されています。

このリポジトリでは、ホストされているサーバーについて説明します。ここからインストールや実行を行う必要はありません。サーバーは CryptoStruct が運用しています。

• エンドポイント： https://cryptostruct.com/mcp（Streamable HTTP、ステートレス、JSON モード）
• OAuth エンドポイント： https://cryptostruct.com/mcp/auth（同じツールを提供します。標準の OAuth フロー（Dynamic Client Registration + PKCE）を開始するために 401 + WWW-Authenticate を返します）
• サーバーカード： /.well-known/mcp/server-card.json
• ドキュメント： https://cryptostruct.com/docs/mcp · 製品ドキュメント：https://docs.cryptostruct.com

API キーは不要です。カタログ、市場統計、ゲスト購入フローはキーなしで利用できます。OAuth でサインインすると（任意）、ユーザーの同意のもとで CryptoStruct アカウントが連携され、注文履歴、購入済みファイルのダウンロード、クレジットでの支払いが利用できます（「データの購入」を参照）。

クイックスタート

Claude Code

claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth

Cursor / 汎用 JSON 設定

{
  "mcpServers": {
    "cryptostruct": {
      "url": "https://cryptostruct.com/mcp"
    }
  }
}

claude.ai — Settings → Connectors → カスタムコネクターを追加 → https://cryptostruct.com/mcp/auth

できること

• カタログと検索： 35 の取引所にまたがる約 50 万件の銘柄（現物、無期限先物、先物、オプション、予測市場）を検索できます。日次アーカイブのカバレッジは 2021-02-08 まで遡ります。
• 予測市場： Kalshi と Polymarket のイベント契約は、第一級の銘柄として扱われます。カタログ（class=prediction）で検索でき、カバレッジ、ライブスナップショット、分足・日足集計を、暗号資産の銘柄と同様に利用できます。契約価格は 0..1（USD）で表示され、売買高は USD 換算で提供されます。
• 市場統計： ライブスナップショットと分足・時間足・日足集計（OHLC、VWAP、取引、売買高、スプレッド、最良気配の板の厚み）に加え、スリッページ／市場インパクト曲線を利用できます。
• データの購入： 生のティックファイルは、暗号資産と予測市場の銘柄を問わず、銘柄・日あたり €1 です。カード決済の場合、サーバーは Stripe のチェックアウト URL を案内します。支払いはユーザーのブラウザーで行われ、サーバーがカード情報に触れることはありません。購入不要で利用できる、日全体を収録した無料サンプルファイルもあります。
• クレジットとエージェントの同意（OAuth サインイン）： ユーザーの同意なしに、エージェントがアカウントのクレジットを使うことはありません。デフォルトでは、create_checkout は approval_required と承認ページを返します。このページでユーザーは注文を承認し（クレジットまたはカードで支払う）、または破棄できます。未承認の注文は、請求されることなく 24 時間後に期限切れになります。ユーザーは https://cryptostruct.com/account/agents で上限付きの自動購入（注文ごとの上限と24時間単位の累積上限）を有効にできます。有効にすると、クレジットで全額をまかなえる注文はすぐに完了し、上限を超える注文は承認待ちになります。エージェントは独自の max_credit_cents を追加で指定できます。preview_checkout を使うと、エージェントは事前に3つの結果のどれになるかを確認できます。これらの設定はウェブサイトでのみ変更でき、エージェントのトークンから変更することはできません。
• アカウントツール（OAuth サインイン）： 注文一覧の取得、購入済みファイルのダウンロード URL の取得、サブスクリプションとクレジット残高、エージェントの支出設定の確認ができます。

ツール

ツール	説明	ティア
get_data_dictionary	データ辞書と製品リファレンス（ファイル形式、単位、価格）	free
search_instruments	銘柄カタログを検索	free
list_venues	対応取引所を一覧表示	free
get_instrument	銘柄の詳細	free
get_coverage	銘柄ごとの日単位のアーカイブ対象期間	free
list_sample_files	無料の終日サンプルファイル	free
get_price_quote	一連のデータファイルの価格見積もり	free
get_market_snapshot	ライブ市場スナップショット（60分＋24時間）	free
get_daily_stats	日次集計（30～180日分は無料、365日分／最大期間はPremium）	free
get_hourly_stats	時間単位の集計（7～90日分は無料、180日分はPremium）	free
get_slippage	スリッページ／市場インパクト曲線（1時間分は無料、24時間分／7日分はPremium）	free
get_top_instruments	ライブの24時間取引高上位銘柄	free
get_movers	24時間の値上がり銘柄と値下がり銘柄	free
get_minutes_range	イベントスタディ用の過去の分単位時系列	premium
create_checkout	購入を開始 — Stripe URL（カード決済）、または approval_required／購入済みとして処理（クレジット、ユーザーの同意設定に従います）	commerce
get_checkout_status	session_id（カード決済）または order_id（サインイン済みユーザー、クレジット／承認注文）で決済状況を確認	commerce
get_order_files	支払い済み注文のファイルとダウンロード URL を一覧表示	commerce
request_file_restore	アーカイブ済み（コールドストレージ）のファイルを復元	commerce
list_my_orders	自分の注文	sign-in
get_my_files	購入済みファイル	sign-in
get_my_subscription	サブスクリプション、クレジット残高、エージェントの支出設定	sign-in
preview_checkout	購入のドライラン：所有済み／利用できないファイル、クレジットでの充当額、および create_checkout が完了するか、承認を求めるか、Stripe に引き継ぐかを確認	sign-in

ティア： free／commerce はキーなしで利用できます。sign-in には確認済み OAuth サインイン（アカウントの種類は問いません）が必要です。premium ツール／パラメーターにはCryptoStruct Premium（月額 €20）が必要です。Premium では、より長い統計期間（日次は365日分／最大期間、時間単位は180日分、スリッページは24時間分／7日分）、より大きな検索上限、get_market_snapshot のデータ品質ブロック、5倍の呼び出し予算も利用できます。ご利用のティアを超える呼び出しには、アップグレード URL を含む静的な AUTH_REQUIRED／PREMIUM_REQUIRED エラーが返され、ハードエラーにはなりません。

レート制限

呼び出し元ごとの重み付き予算：キーなしの場合は毎分120単位（IPごと）、サインイン済みユーザーの場合はユーザーごとに毎分120単位、Premium の場合は毎分600単位です。低コストのカタログ読み取りは1単位、上流への負荷が大きい統計取得は3～5単位、決済処理は10単位です。RATE_LIMITED エラーが発生した場合は、指定された秒数だけ待ってから再試行してください。

規約

• すべてのファイルサイズは圧縮後（zstd）のバイト数です。市場価格は USD、販売価格は EUR です。
• 分単位のデータは上流で約30日間保持されます。時間単位／日単位の集計は、さらに過去までさかのぼって取得できます。
• ティックファイルは終日分の JSON Lines 形式の記録です（オーダーブックのスナップショットと更新、取引、清算、ファンディング、オプションのグリークスを含むマーク／インデックス）。形式のリファレンス：市場データプロトコル。

関連情報

• ティックファイルの解析用 エージェントスキル：cryptostruct-market-data（zip）
• スキルの検出インデックス：/.well-known/agent-skills/index.json
• API カタログ（RFC 9727）：/.well-known/api-catalog
• llms.txt：https://cryptostruct.com/llms.txt

サポート

質問や問題については、こちらをご覧ください：https://cryptostruct.com/contact