0xArchive MCP-Server

Fragen Sie Kryptomarktdaten über Hyperliquid, HIP-3 und Lighter.xyz mithilfe natürlicher Sprache in Claude ab.

79 Tools decken Orderbücher, Trades, Kerzencharts, Finanzierungsraten, Open Interest, Liquidationen, L4-Daten auf Order-Ebene, Datenqualitätsmetriken und Wallet-basierte Authentifizierung ab – von April 2023 bis in Echtzeit.

Schnellstart (30 Sekunden)

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

Fragen Sie dann Claude: "Wie hoch ist die aktuelle Finanzierungsrate von BTC?"

Nutzungsbeispiele

Fragen Sie Claude...	Ausgelöstes Tool
"Gib mir eine BTC-Marktzusammenfassung"	`get_summary`
"Zeige ETH 4h-Kerzen der letzten Woche"	`get_candles`
"Was ist die aktuelle Finanzierungsrate für SOL?"	`get_funding_current`
"Vergleiche die BTC-Finanzierung auf Hyperliquid vs. Lighter"	`get_funding_current` + `get_lighter_funding_current`
"Zeige mir SOL-Liquidationen der letzten 24 Stunden"	`get_liquidations`
"Hole das BTC-Orderbuch mit 20 Ebenen"	`get_orderbook`
"Gab es diesen Monat Datenvorfälle?"	`get_data_incidents`
"Was ist der km:US500-Preis auf HIP-3?"	`get_hip3_summary`
"Zeige mir den SLA-Bericht für Januar 2026"	`get_data_sla`

Einrichtung (detailliert)

1. Installieren & Bauen

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

2. API-Schlüssel erhalten

Registrieren Sie sich unter 0xarchive.io und generieren Sie einen API-Schlüssel im Dashboard. Oder nutzen Sie die Tools web3_challenge und web3_signup, um einen kostenlosen API-Schlüssel nur mit einer Ethereum-Wallet zu erhalten – kein Browser erforderlich.

3. Zu Claude Code hinzufügen

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. Zu Claude Desktop hinzufügen

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Verfügbare Tools (79)

Hyperliquid

Tool	Beschreibung
`get_instruments`	Alle Hyperliquid Perp/Spot-Instrumente auflisten
`get_instrument`	Ein einzelnes Hyperliquid-Instrument nach Coin abrufen
`get_orderbook`	Aktueller L2-Orderbuch-Snapshot
`get_orderbook_history`	Historische Orderbuch-Snapshots
`get_trades`	Trade-/Fill-Historie
`get_candles`	OHLCV-Kerzendaten
`get_funding_current`	Aktuelle Finanzierungsrate
`get_funding_history`	Historie der Finanzierungsraten
`get_open_interest`	Aktuelles Open Interest
`get_open_interest_history`	Historie des Open Interest
`get_liquidations`	Liquidationshistorie
`get_liquidations_by_user`	Liquidationen für eine bestimmte Benutzeradresse
`get_liquidation_volume`	Aggregiertes Liquidationsvolumen (USD-Buckets)
`get_freshness`	Datenaktualität und Verzögerung pro Coin
`get_summary`	Kombinierte Marktzusammenfassung (Preis, Finanzierung, OI, Volumen, Liquidationen)
`get_price_history`	Historie der Mark-/Oracle-/Mid-Preise

Hyperliquid L4 (Order-Ebene)

Tool	Beschreibung
`get_order_history`	Orderhistorie mit Benutzerzuordnung (Build+-Stufe)
`get_order_flow`	Aggregierte Metriken zu Orderplatzierung, Stornierung und Ausführung (Build+-Stufe)
`get_tpsl`	TP/SL-Orderhistorie mit Trigger-Preisen und Trigger-Status (Pro+-Stufe)
`get_l4_orderbook`	L4-Orderbuch-Rekonstruktion zu einem bestimmten Zeitstempel (Pro+-Stufe)
`get_l4_diffs`	Rohdaten zu Änderungen auf Order-Ebene (neu, geändert, storniert, ausgeführt) über einen Zeitraum (Pro+-Stufe)
`get_l4_orderbook_history`	Periodische vollständige Orderbuch-Checkpoints auf Order-Ebene (Pro+-Stufe)

Hyperliquid L2 (Volle Tiefe)

Tool	Beschreibung
`get_l2_orderbook`	L2-Orderbuch mit voller Tiefe, abgeleitet von L4 (Build+-Stufe)
`get_l2_orderbook_history`	Historische L2-Orderbuch-Snapshots mit voller Tiefe (Build+-Stufe)
`get_l2_diffs`	L2-Differenzen auf Tick-Ebene (Pro+-Stufe)

HIP-3 (Builder Perps)

Tool	Beschreibung
`get_hip3_instruments`	HIP-3-Instrumente auflisten
`get_hip3_instrument`	Ein einzelnes HIP-3-Instrument nach Coin abrufen
`get_hip3_orderbook`	Aktuelles HIP-3-Orderbuch
`get_hip3_orderbook_history`	Historische HIP-3-Orderbuch-Snapshots
`get_hip3_trades`	HIP-3-Trade-Historie
`get_hip3_trades_recent`	Aktuellste HIP-3-Trades
`get_hip3_candles`	HIP-3-Kerzendaten
`get_hip3_funding_current`	Aktuelle HIP-3-Finanzierungsrate
`get_hip3_funding`	HIP-3-Finanzierungshistorie
`get_hip3_open_interest`	Aktuelles HIP-3-Open Interest
`get_hip3_open_interest_history`	HIP-3-Open-Interest-Historie
`get_hip3_liquidations`	HIP-3-Liquidationsereignisse (ab Feb 2026)
`get_hip3_liquidation_volume`	Aggregiertes HIP-3-Liquidationsvolumen (USD-Buckets, ab Feb 2026)
`get_hip3_freshness`	HIP-3-Datenaktualität und Verzögerung pro Coin
`get_hip3_summary`	Kombinierte HIP-3-Marktzusammenfassung
`get_hip3_price_history`	HIP-3-Historie der Mark-/Oracle-/Mid-Preise

HIP-3 L4 (Order-Ebene)

Tool	Beschreibung
`get_hip3_order_history`	HIP-3-Orderhistorie mit Benutzerzuordnung (Build+-Stufe)
`get_hip3_order_flow`	Aggregierte HIP-3-Metriken zu Orderplatzierung, Stornierung und Ausführung (Build+-Stufe)
`get_hip3_tpsl`	HIP-3-TP/SL-Orderhistorie mit Trigger-Preisen und Trigger-Status (Pro+-Stufe)
`get_hip3_l4_orderbook`	HIP-3-L4-Orderbuch-Rekonstruktion zu einem bestimmten Zeitstempel (Pro+-Stufe)
`get_hip3_l4_diffs`	HIP-3-Rohdaten zu Änderungen auf Order-Ebene über einen Zeitraum (Pro+-Stufe)
`get_hip3_l4_orderbook_history`	HIP-3-periodische vollständige Orderbuch-Checkpoints auf Order-Ebene (Pro+-Stufe)

HIP-3 L2 (Volle Tiefe)

Tool	Beschreibung
`get_hip3_l2_orderbook`	HIP-3-L2-Orderbuch mit voller Tiefe, abgeleitet von L4 (Build+-Stufe)
`get_hip3_l2_orderbook_history`	HIP-3-L2-Orderbuch-Historie mit voller Tiefe (Build+-Stufe)
`get_hip3_l2_diffs`	HIP-3-L2-Differenzen auf Tick-Ebene (Pro+-Stufe)

Lighter.xyz

Tool	Beschreibung
`get_lighter_instruments`	Lighter-Instrumente auflisten
`get_lighter_instrument`	Ein einzelnes Lighter-Instrument nach Coin abrufen
`get_lighter_orderbook`	Aktuelles Lighter-Orderbuch
`get_lighter_orderbook_history`	Historische Lighter-Orderbuch-Snapshots
`get_lighter_trades`	Lighter-Trade-Historie
`get_lighter_trades_recent`	Aktuellste Lighter-Trades
`get_lighter_candles`	Lighter-Kerzendaten
`get_lighter_funding_current`	Aktuelle Lighter-Finanzierungsrate
`get_lighter_funding`	Lighter-Finanzierungshistorie
`get_lighter_open_interest`	Aktuelles Lighter-Open Interest
`get_lighter_open_interest_history`	Lighter-Open-Interest-Historie
`get_lighter_freshness`	Lighter-Datenaktualität und Verzögerung pro Coin
`get_lighter_summary`	Kombinierte Lighter-Marktzusammenfassung
`get_lighter_price_history`	Lighter-Historie der Mark-/Oracle-/Mid-Preise

Lighter L3 (Order-Ebene)

Tool	Beschreibung
`get_lighter_l3_orderbook`	Aktuelles L3-Orderbuch auf Order-Ebene mit Order-IDs und Benutzeradressen (Pro+-Stufe)
`get_lighter_l3_orderbook_history`	Historische L3-Orderbuch-Snapshots mit einzelnen Orders (Pro+-Stufe)

Datenqualität

Tool	Beschreibung
`get_data_quality_status`	Systemzustand über alle Börsen hinweg
`get_data_coverage`	Datenabdeckung (früheste/neueste, Datensätze, Vollständigkeit)
`get_exchange_coverage`	Abdeckung für eine bestimmte Börse
`get_symbol_coverage`	Abdeckung pro Symbol mit Lückenerkennung
`get_data_incidents`	Historie von Ausfällen und Verschlechterungen
`get_incident`	Details zu einem einzelnen Vorfall nach ID
`get_data_latency`	WebSocket-/REST-Latenz und Datenaktualität
`get_data_sla`	Monatlicher SLA-Compliance-Bericht

Web3-Authentifizierung

Tool	Beschreibung
`web3_challenge`	Eine SIWE-Challenge-Nachricht für eine Wallet-Adresse abrufen
`web3_signup`	Ein Konto der kostenlosen Stufe und einen API-Schlüssel mit einer signierten SIWE-Nachricht erstellen
`web3_list_keys`	Alle API-Schlüssel für eine Wallet auflisten
`web3_revoke_key`	Einen bestimmten API-Schlüssel widerrufen
`web3_subscribe`	Eine kostenpflichtige Stufe (Build/Pro) über x402 USDC-Zahlung auf Base abonnieren

Ablauf kostenlose Stufe: web3_challenge (SIWE-Nachricht abrufen) → mit personal_sign (EIP-191) signieren → web3_signup (Signatur übermitteln) → API-Schlüssel erhalten.

Ablauf kostenpflichtige Stufe (x402): web3_subscribe mit Stufe → gibt 402 mit Preisgestaltung zurück → USDC-Transfer signieren (EIP-3009 auf Base) → web3_subscribe erneut mit payment_signature aufrufen → API-Schlüssel + Abonnement erhalten.

Preisstufen

Einige Endpunkte erfordern einen kostenpflichtigen Plan. Der Server gibt klare Fehlermeldungen mit Upgrade-Hinweisen zurück, wenn Stufenlimits erreicht werden.

Stufe	Preis	Zugriff
Kostenlos	$0/Monat	Nur historische BTC-Daten
Build	$49/Monat	Alle Coins, REST-API, 25 WS-Subs
Pro	$199/Monat	Volle Orderbuch-Tiefe, 100 WS-Subs
Enterprise	Benutzerdefiniert	Tick-Daten, 200 WS-Subs

Upgrade unter 0xarchive.io/pricing.

Tool-Annotationen

Alle 79 Tools enthalten MCP-Annotationen, damit Clients über Sicherheit und Wiederholungsverhalten entscheiden können.

Marktdaten-Tools (74):

Annotation	Wert	Bedeutung
`readOnlyHint`	`true`	Tools ändern niemals Daten
`destructiveHint`	`false`	Keine destruktiven Seiteneffekte
`idempotentHint`	`true`	Sicher bei Fehlern zu wiederholen
`openWorldHint`	`true`	Fragt eine externe API ab

Web3-Tools (5): readOnlyHint: false, idempotentHint: false – diese erstellen Konten, Schlüssel und Abonnements.

Alle Tools deklarieren zudem ein outputSchema, damit Clients strukturierte Antworten validieren können.

Intelligente Standardwerte

Zeitraum: Standardmäßig die letzten 24 Stunden, falls nicht anders angegeben
Limit: Standardmäßig 100 Datensätze
Intervall: Standardmäßig 1h für Kerzencharts
Paginierung: Gibt einen Cursor für die nächste Seite zurück, wenn weitere Daten verfügbar sind
Zeitstempel: Akzeptiert sowohl Unix-Millisekunden als auch ISO 8601-Strings

Massendaten-Downloads

Für groß angelegte Datenexporte (vollständige Orderbücher, komplette Trade-Historie usw.) verwenden Sie den S3 Parquet-Massenexport unter 0xarchive.io/data. Der Data Explorer ermöglicht es Ihnen, Zeiträume, Symbole und Datentypen auszuwählen und dann komprimierte Parquet-Dateien direkt herunterzuladen. Die MCP-Tools eignen sich am besten für Punktabfragen und mittelgroße Datenabrufe; für Massenanforderungen ist der Data Explorer deutlich schneller.

0xarchive-mcp