deribit-mcp

Binde Deribit in deinen KI-Assistenten ein. Unterstützt beliebige MCP-Clients wie Claude Code, Codex usw. Mit einem einzigen Befehl angeschlossen, kann der Assistent Kurse abfragen, Konten einsehen und Aufträge verwalten.

claude mcp add deribit -- npx -y deribit-mcp

Nach der Installation kannst du fragen: „Wie sieht die aktuelle Optionskette für BTC aus?“, „Zeig mir die implizite Volatilität der Call-Optionen mit Fälligkeit im März“, „Wie viel verfügbare Marge habe ich noch auf meinem Konto?“

Zwei Sicherheitsstandards: Standardmäßig wird das Testnetz verwendet, standardmäßig ist Handel deaktiviert. Um echte Aufträge zu platzieren, müssen beide Optionen explizit aktiviert werden.

Installation

Claude Code

Nur für Marktdaten, keine Konfiguration erforderlich:

claude mcp add deribit -- npx -y deribit-mcp

Für Konten- und Auftragsabfragen API-Anmeldedaten hinzufügen und zum Hauptnetz wechseln:

claude mcp add deribit \
  --env DERIBIT_ENV=prod \
  --env DERIBIT_CLIENT_ID=你的_client_id \
  --env DERIBIT_CLIENT_SECRET=你的_client_secret \
  -- npx -y deribit-mcp

Codex

Bearbeite ~/.codex/config.toml (oder .codex/config.toml im Projekt):

[mcp_servers.deribit]
command = "npx"
args = ["-y", "deribit-mcp"]

[mcp_servers.deribit.env]
DERIBIT_ENV = "prod"
DERIBIT_CLIENT_ID = "你的_client_id"
DERIBIT_CLIENT_SECRET = "你的_client_secret"

Andere MCP-Clients

Jeder Client, der stdio unterstützt, kann verwendet werden. Der Befehl lautet npx -y deribit-mcp, die Konfiguration erfolgt über Umgebungsvariablen.

Aus dem Quellcode ausführen (optional)

Wenn du eine bestimmte Version festlegen oder eigenen Code geändert hast, kannst du direkt auf den Quellcode verweisen, ohne nach jeder Änderung neu bauen zu müssen:

git clone https://github.com/freeeverett/deribit-mcp.git
cd deribit-mcp && npm install

[mcp_servers.deribit]
command = "npx"
args = ["tsx", "/绝对路径/deribit-mcp/src/index.ts"]

Der Preis dafür ist eine etwa doppelt so lange Startzeit (ca. 160 ms vs. 77 ms), und die Abhängigkeiten müssen lokal installiert sein. Für den täglichen Gebrauch wird weiterhin npx -y deribit-mcp empfohlen.

API-Anmeldedaten abrufen

Erstelle einen Key unter Deribit-Kontoeinstellungen → API.

Empfehlung: nach dem Prinzip der geringsten Rechte vorgehen. Wenn der Assistent nur analysieren soll, reicht trade:read – selbst wenn der Handels-Schalter versehentlich aktiviert wird, können keine Aufträge platziert werden.

Related MCP server: Crypto Options Desk MCP

Konfigurationsoptionen

Das Testnetz ist unabhängig: Die Konten und API-Keys von test.deribit.com sind mit dem Hauptnetz vollständig inkompatibel. Du musst dich unter test.deribit.com separat registrieren. Im Testnetz kannst du kostenlos Testcoins erhalten. Ideal, um den Ablauf zuerst durchzuspielen, bevor du zum Hauptnetz wechselst.

Vollständiger Integrationstest im Testnetz

Erstelle im Projektstammverzeichnis die von git ignorierte Datei .env.test und trage nur die Testnetz-API-Anmeldedaten ein:

DERIBIT_CLIENT_ID=你的测试网_client_id
DERIBIT_CLIENT_SECRET=你的测试网_client_secret

Dann ausführen:

npm run test:all

Dieser Einstiegspunkt liest nativ .env.test und erzwingt die Verbindung zum Testnetz (Einstellungen für Hauptnetz oder benutzerdefinierte Endpunkte aus der Datei werden nicht übernommen). Er führt über einen echten stdio-MCP-Client alle 39 Tools aus und verlangt einen Key mit trade:read_write: Es werden Limitaufträge mit eindeutigem Test-Tag erstellt, geändert und storniert, kurzzeitig Marktaufträge zum Öffnen und Schließen von Positionen ausgeführt und eine Test-Kombination erstellt. Beim Beenden des Skripts werden offene Aufträge anhand dieses Tags als Fallback storniert; schlägt die Bereinigung fehl, beendet sich der Befehl mit einem Fehler. Das bestehende npm run smoke bleibt ein schneller öffentlicher API-Regressionstest ohne Anmeldedaten.

Über die Handelsfunktionen

Die auftragsbezogenen Tools sind standardmäßig nicht freigeschaltet – wenn du DERIBIT_ENABLE_TRADING=true nicht setzt, sieht dein Assistent diese Tools gar nicht erst und kann sie also auch nicht versehentlich auslösen.

Nach dem Aktivieren verfügbar: Auftrag erteilen, Auftrag ändern, Auftrag stornieren, Position schließen, Kombinationskontrakt erstellen.

Bitte unbedingt beachten:

• Diese Aktionen erzeugen echte Ausführungen auf deinem echten Konto – es geht um echtes Geld

• Es wird empfohlen, den Ablauf zuerst im Testnetz zu üben, bevor du das Hauptnetz in Betracht ziehst

• Bei Hauptnetz + aktiviertem Handel gibt der Dienst beim Start eine explizite Warnung aus, und der Assistent erhält die Anweisung, „vor der Ausführung die Bestätigung des Benutzers einzuholen“

• Aber das letzte Tor bist du selbst: Lies jeden Auftragserteilungs-Wunsch genau durch, bevor du zustimmst

Wenn du möchtest, dass der Assistent nur analysiert und keine Aufträge anfasst, lasse diesen Schalter aus – Marktdaten- und Kontenabfragen sind davon völlig unberührt.

Was möglich ist

Insgesamt 39 Tools.

Marktdaten (18, ohne Anmeldedaten)

Kontrakt- und Währungslisten, Kontraktspezifikationen, Verfallstermine, Optionsketten (Open Interest / implizite Volatilität / Geld- und Briefkurse), Echtzeitkurse und Orderbuchtiefe, Options-Greeks, historische Kerzen, Mark-Preis-Verlauf, Indexpreis aktuell und historisch, historische realisierte Volatilität, DVOL-Volatilitätsindex, Perpetual-Funding-Raten, gesamte Markttransaktionen, Börsenvolumen, APR für zinstragende Token, Abrechnungspreise, Abrechnungs- und Liquidierungsdatensätze, Kombinationskontrakte, Plattformstatus, Börsenankündigungen.

Konto und Aufträge (16, mit Anmeldedaten)

Kontoeigenkapital und Margin, Übersicht über alle Währungen und Kontosperre, Positionsdetails, Unterkontoliste, Portfolio-Margin-Simulation, Zahlungsströme, Abrechnungs- und Lieferdatensätze, Einzahlungs-, Auszahlungs- und Transferverlauf, aktuelle offene Aufträge, Auftragsstatus, Auftragshistorie, Verlauf von Trigger-Aufträgen, Ausführungsdetails, Ausführungen einzelner Aufträge, Margin-Schätzung für Auftragserteilung.

Handel (5, mit Anmeldedaten und explizit freigeschaltet)

Auftrag erteilen (Limit / Markt / Stop-Loss / Take-Profit / Trailing-Stop / Iceberg / erweiterte Optionspreisgestaltung), Auftrag ändern, Auftrag stornieren, Position schließen, mehrbeinige Kombinationskontrakte erstellen.

Die vollständige Zuordnung von Tools und API-Endpunkten findest du in docs/API-COVERAGE.md.

So liest du die Versionsnummer

Die Versionsnummer hat die Form 2.20260721.0:

• 2 — Hauptversion der Deribit-API (v2)

• 20260721 — Veröffentlichungsdatum der Deribit-Offizialdokumentation, auf das abgestimmt ist (2026-07-21)

• 0 — die wievielte Überarbeitung innerhalb dieser Dokumentationsversion

Das heißt: Anhand des mittleren Teils erkennst du, auf welchen Stand der Deribit-Dokumentation diese Version sich bezieht. Wenn Deribit die API aktualisiert, wird dieses Projekt den mittleren Teil entsprechend auf das neue Datum anheben.

Häufig gestellte Fragen

Der Assistent sagt, er findet die Deribit-Tools nicht?

Prüfe die MCP-Logs des Clients. Beim Start schreibt der Dienst die aktuelle Umgebung, den Anmeldedatenstatus und die Anzahl der registrierten Tools nach stderr – so ist auf einen Blick erkennbar, ob die Konfiguration nicht greift oder ein anderes Problem vorliegt.

Du siehst nur die Marktdaten-Tools, aber keine Kontotools?

Das bedeutet, die Anmeldedaten wurden nicht gelesen. Stelle sicher, dass DERIBIT_CLIENT_ID und DERIBIT_CLIENT_SECRET beide gesetzt sind – wenn nur eines gesetzt ist, schlägt der Dienststart direkt fehl und gibt an, welches fehlt.

Du siehst keine Auftragstools?

Dafür sind DERIBIT_ENABLE_TRADING=true und konfigurierte Anmeldedaten erforderlich. Das ist das beabsichtigte Standardverhalten.

Fehler invalid_credentials?

Der Key oder das Secret ist falsch, oder es wurde ein Testnetz-Key verwendet, während eine Verbindung zum Hauptnetz besteht (oder umgekehrt). Die Konten der beiden Umgebungen sind nicht kompatibel.

Fehler wegen unzureichendem Scope?

Der API-Key hat keine trade:read_write-Berechtigung. Der Dienst meldet den Fehler vor der Auftragserteilung, damit du nicht fälschlich annimmst, der Auftrag sei bereits gesendet. Füge dem Key im Deribit-Backend die Berechtigung hinzu oder deaktiviere den Handels-Schalter.

Konfigurationsänderungen haben keine Wirkung?

Der MCP-Dienst wird beim Start des Clients gestartet. Nach Änderungen an Umgebungsvariablen muss der Client neu gestartet werden.

Lizenz

MIT