0xArchive MCPサーバー

Claudeで自然言語を使用して、Hyperliquid、HIP-3、Lighter.xyzの暗号資産市場データをクエリします。

オーダーブック、取引、ローソク足、資金調達率、建玉、清算、L4オーダーレベルデータ、データ品質メトリクス、ウォレットベースの認証を網羅する79のツールを提供 — 2023年4月からリアルタイムデータまで対応。

クイックスタート (30秒)

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp && npm install && npm run build
claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node $(pwd)/build/index.js

次にClaudeにこう尋ねてください： 「BTCの現在の資金調達率は？」

使用例

Claudeへの質問	実行されるツール
「BTCの市場概要を教えて」	`get_summary`
「過去1週間のETHの4時間足を表示して」	`get_candles`
「SOLの現在の資金調達率は？」	`get_funding_current`
「HyperliquidとLighterのBTC資金調達率を比較して」	`get_funding_current` + `get_lighter_funding_current`
「過去24時間のSOLの清算状況を表示して」	`get_liquidations`
「BTCのオーダーブックを20レベルで取得して」	`get_orderbook`
「今月、データインシデントはあった？」	`get_data_incidents`
「HIP-3のkm:US500の価格は？」	`get_hip3_summary`
「2026年1月のSLAレポートを表示して」	`get_data_sla`

セットアップ (詳細)

1. インストールとビルド

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp
npm install
npm run build

2. APIキーの取得

0xarchive.ioにサインアップし、ダッシュボードでAPIキーを生成します。または、web3_challengeおよびweb3_signupツールを使用して、ブラウザ不要でイーサリアムウォレットのみで無料のAPIキーを取得することも可能です。

3. Claude Codeへの追加

claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node /absolute/path/to/0xarchive-mcp/build/index.js

4. Claude Desktopへの追加

claude_desktop_config.jsonに以下を追加します：

{
  "mcpServers": {
    "0xarchive": {
      "command": "node",
      "args": ["/absolute/path/to/0xarchive-mcp/build/index.js"],
      "env": {
        "OXARCHIVE_API_KEY": "0xa_your_api_key"
      }
    }
  }
}

利用可能なツール (79)

Hyperliquid

ツール	説明
`get_instruments`	すべてのHyperliquid無期限/現物銘柄をリストアップ
`get_instrument`	コイン別に単一のHyperliquid銘柄を取得
`get_orderbook`	現在のL2オーダーブックのスナップショット
`get_orderbook_history`	過去のオーダーブックのスナップショット
`get_trades`	取引/約定履歴
`get_candles`	OHLCVローソク足データ
`get_funding_current`	現在の資金調達率
`get_funding_history`	資金調達率の履歴
`get_open_interest`	現在の建玉
`get_open_interest_history`	建玉の履歴
`get_liquidations`	清算履歴
`get_liquidations_by_user`	特定のユーザーアドレスの清算履歴
`get_liquidation_volume`	集計された清算ボリューム (USDバケット)
`get_freshness`	コインごとのデータ鮮度と遅延
`get_summary`	統合市場概要 (価格、資金調達率、建玉、ボリューム、清算)
`get_price_history`	マーク/オラクル/中間価格の履歴

Hyperliquid L4 (オーダーレベル)

ツール	説明
`get_order_history`	ユーザー属性付きの注文履歴 (Build+ティア)
`get_order_flow`	集計された注文発注、キャンセル、約定メトリクス (Build+ティア)
`get_tpsl`	トリガー価格とトリガー状態を含むTP/SL注文履歴 (Pro+ティア)
`get_l4_orderbook`	特定のタイムスタンプでのL4オーダーブック再構築 (Pro+ティア)
`get_l4_diffs`	時間範囲にわたる生のオーダーレベルの変更 (新規、修正、キャンセル、約定) (Pro+ティア)
`get_l4_orderbook_history`	定期的なフルオーダーレベルのオーダーブックチェックポイント (Pro+ティア)

Hyperliquid L2 (フルデプス)

ツール	説明
`get_l2_orderbook`	L4から導出されたL2フルデプスオーダーブック (Build+ティア)
`get_l2_orderbook_history`	過去のL2フルデプスオーダーブックのスナップショット (Build+ティア)
`get_l2_diffs`	L2ティックレベルの差分 (Pro+ティア)

HIP-3 (Builder Perps)

ツール	説明
`get_hip3_instruments`	HIP-3銘柄をリストアップ
`get_hip3_instrument`	コイン別に単一のHIP-3銘柄を取得
`get_hip3_orderbook`	現在のHIP-3オーダーブック
`get_hip3_orderbook_history`	過去のHIP-3オーダーブックのスナップショット
`get_hip3_trades`	HIP-3取引履歴
`get_hip3_trades_recent`	最新のHIP-3取引
`get_hip3_candles`	HIP-3ローソク足データ
`get_hip3_funding_current`	現在のHIP-3資金調達率
`get_hip3_funding`	HIP-3資金調達率の履歴
`get_hip3_open_interest`	現在のHIP-3建玉
`get_hip3_open_interest_history`	HIP-3建玉の履歴
`get_hip3_liquidations`	HIP-3清算イベント (2026年2月以降)
`get_hip3_liquidation_volume`	集計されたHIP-3清算ボリューム (USDバケット、2026年2月以降)
`get_hip3_freshness`	コインごとのHIP-3データ鮮度と遅延
`get_hip3_summary`	統合HIP-3市場概要
`get_hip3_price_history`	HIP-3マーク/オラクル/中間価格の履歴

HIP-3 L4 (オーダーレベル)

ツール	説明
`get_hip3_order_history`	ユーザー属性付きのHIP-3注文履歴 (Build+ティア)
`get_hip3_order_flow`	集計されたHIP-3注文発注、キャンセル、約定メトリクス (Build+ティア)
`get_hip3_tpsl`	トリガー価格とトリガー状態を含むHIP-3 TP/SL注文履歴 (Pro+ティア)
`get_hip3_l4_orderbook`	特定のタイムスタンプでのHIP-3 L4オーダーブック再構築 (Pro+ティア)
`get_hip3_l4_diffs`	時間範囲にわたるHIP-3の生のオーダーレベルの変更 (Pro+ティア)
`get_hip3_l4_orderbook_history`	HIP-3の定期的なフルオーダーレベルのオーダーブックチェックポイント (Pro+ティア)

HIP-3 L2 (フルデプス)

ツール	説明
`get_hip3_l2_orderbook`	L4から導出されたHIP-3 L2フルデプスオーダーブック (Build+ティア)
`get_hip3_l2_orderbook_history`	HIP-3 L2フルデプスオーダーブックの履歴 (Build+ティア)
`get_hip3_l2_diffs`	HIP-3 L2ティックレベルの差分 (Pro+ティア)

Lighter.xyz

ツール	説明
`get_lighter_instruments`	Lighter銘柄をリストアップ
`get_lighter_instrument`	コイン別に単一のLighter銘柄を取得
`get_lighter_orderbook`	現在のLighterオーダーブック
`get_lighter_orderbook_history`	過去のLighterオーダーブックのスナップショット
`get_lighter_trades`	Lighter取引履歴
`get_lighter_trades_recent`	最新のLighter取引
`get_lighter_candles`	Lighterローソク足データ
`get_lighter_funding_current`	現在のLighter資金調達率
`get_lighter_funding`	Lighter資金調達率の履歴
`get_lighter_open_interest`	現在のLighter建玉
`get_lighter_open_interest_history`	Lighter建玉の履歴
`get_lighter_freshness`	コインごとのLighterデータ鮮度と遅延
`get_lighter_summary`	統合Lighter市場概要
`get_lighter_price_history`	Lighterマーク/オラクル/中間価格の履歴

Lighter L3 (オーダーレベル)

ツール	説明
`get_lighter_l3_orderbook`	注文IDとユーザーアドレスを含む現在のL3オーダーレベルのオーダーブック (Pro+ティア)
`get_lighter_l3_orderbook_history`	個別の注文を含む過去のL3オーダーブックのスナップショット (Pro+ティア)

データ品質

ツール	説明
`get_data_quality_status`	すべての取引所におけるシステム健全性
`get_data_coverage`	データカバレッジ (最初/最後、レコード数、完全性)
`get_exchange_coverage`	特定の取引所のカバレッジ
`get_symbol_coverage`	ギャップ検出を含むシンボルごとのカバレッジ
`get_data_incidents`	障害および劣化の履歴
`get_incident`	IDによる単一のインシデント詳細
`get_data_latency`	WebSocket/RESTの遅延とデータの鮮度
`get_data_sla`	月次SLAコンプライアンスレポート

Web3認証

ツール	説明
`web3_challenge`	ウォレットアドレス用のSIWEチャレンジメッセージを取得
`web3_signup`	署名済みSIWEメッセージを使用して無料ティアのアカウントとAPIキーを作成
`web3_list_keys`	ウォレットのすべてのAPIキーをリストアップ
`web3_revoke_key`	特定のAPIキーを取り消す
`web3_subscribe`	Base上のx402 USDC支払いを通じて有料ティア (build/pro) をサブスクライブ

無料ティアフロー: web3_challenge (SIWEメッセージ取得) → personal_sign (EIP-191) で署名 → web3_signup (署名を送信) → APIキーを受信。

有料ティアフロー (x402): ティアを指定して web3_subscribe → 価格を含む402を返す → USDC転送に署名 (Base上のEIP-3009) → payment_signature を付けて再度 web3_subscribe → APIキーとサブスクリプションを受信。

料金ティア

一部のエンドポイントは有料プランが必要です。ティア制限に達した場合、サーバーはアップグレードの案内を含む明確なエラーメッセージを返します。

ティア	価格	アクセス
Free	$0/月	BTCのみの過去データ
Build	$49/月	全コイン、REST API、25 WSサブスク
Pro	$199/月	フルオーダーブックデプス、100 WSサブスク
Enterprise	カスタム	ティックデータ、200 WSサブスク

アップグレードは 0xarchive.io/pricing から。

ツールのアノテーション

79のすべてのツールには、クライアントが安全性と再試行動作を判断できるようにMCPアノテーションが付与されています。

市場データツール (74):

アノテーション	値	意味
`readOnlyHint`	`true`	ツールはデータを変更しません
`destructiveHint`	`false`	破壊的な副作用はありません
`idempotentHint`	`true`	失敗時に再試行しても安全です
`openWorldHint`	`true`	外部APIをクエリします

Web3ツール (5): readOnlyHint: false, idempotentHint: false — これらはアカウント、キー、サブスクリプションを作成します。

すべてのツールは outputSchema も宣言しており、クライアントは構造化されたレスポンスを検証できます。

スマートデフォルト

時間範囲: 指定がない場合は過去24時間をデフォルトとします
制限: デフォルトで100レコード
間隔: ローソク足のデフォルトは1時間
ページネーション: さらにデータがある場合は次のページのカーソルを返します
タイムスタンプ: Unixミリ秒とISO 8601文字列の両方を受け付けます

大規模データダウンロード

大規模なデータエクスポート (フルオーダーブック、完全な取引履歴など) には、0xarchive.io/data で利用可能なS3 Parquetバルクエクスポートを使用してください。データエクスプローラーでは、時間範囲、シンボル、データ型を選択し、圧縮されたParquetファイルを直接ダウンロードできます。MCPツールはポイントクエリや中規模のデータ取得に最適です。大規模なニーズには、データエクスプローラーの方が大幅に高速です。

0xarchive-mcp