Zum Hauptinhalt springen
Die Helius CLI ist eine umfassende Befehlszeilenschnittstelle für die Helius-Plattform. Sie bietet über 95 Befehle für Kontoverwaltung, Abfragen von Blockchain-Daten, das Senden von Transaktionen, webhook, Echtzeit-Streaming, Staking, ZK Compression und mehr. Jeder Befehl kann maschinenlesbares JSON ausgeben.
Verwendest du ein MCP-kompatibles KI-Tool? Der Helius MCP-Server ist die empfohlene Methode, mit der KI-Agenten mit Helius interagieren. Er bietet 10 weitergeleitete Tools mit strukturierten Ein- und Ausgaben, einschließlich integrierter Kontoregistrierung. Verwende die CLI für Shell-Skripte und CI/CD-Pipelines oder wenn MCP nicht verfügbar ist.

Installation

Schnellstart — Bestehende Benutzer

Wenn du bereits einen Helius API key hast, lege ihn einfach fest und beginne:
Du findest deinen API key unter dashboard.helius.dev. Das war’s. Überspringe die folgenden Registrierungsschritte.

Schnellstart — Neue Benutzer

Aufrufe von helius signup, die ein Konto erstellen, erfordern --email, --first-name und --last-name — auch beim Agent-Tarif. Deine Wallet wird nur zum Bezahlen verwendet. Sie ersetzt deine Kontaktdaten nicht. helius signup --resume schließt eine bestehende Registrierung nach der Zahlung über den gehosteten Link ab und benötigt keine weiteren Flags.
1

Generate a keypair

Ausgabe:
Der obige Hinweis zur Einzahlung gilt nur, wenn du die automatische Zahlung verwendest. Wenn du über den gehosteten Link bezahlen möchtest, musst du kein Guthaben einzahlen.
2

Create account

Es gibt zwei Zahlungsarten: einen gehosteten Link, über den du mit einer beliebigen Wallet bezahlst und kein Guthaben einzahlen musst, oder die automatische Zahlung. Dabei bezahlst du USDC über das lokale Schlüsselpaar, das etwa 0,001 SOL plus den Tarifbetrag enthalten muss.
3

Get your API keys and endpoints

Dein API key ist eine vertrauliche Information, die Zugriff auf dein Helius-Konto gewährt. Lege ihn niemals in clientseitigem Code, öffentlichen Repositorys oder über den Browser zugänglichen Bereichen offen.

Tarife und Preise

Du kannst jeden gemeinsam genutzten Helius-Tarif direkt über die CLI erwerben. Übergib bei der Registrierung --plan oder verwende später helius upgrade:
Alle in Dollar angegebenen Preise verstehen sich in US-Dollar (USD).
Der Agent-Tarif (agent) ist der Standard. Er kostet $10 (zahlbar in USDC), um Missbrauch zu verhindern, und umfasst 1,000,000 Credits. Registriere dich für einen kostenpflichtigen Tarif oder führe später ein Upgrade durch, um höhere rate limits und mehr Credits zu erhalten.

Mit einem bestimmten Tarif registrieren

Bestehendes Konto upgraden

Verlängerung bezahlen

Wenn eine Abonnementverlängerung fällig ist (monatlich oder jährlich), erstellt Helius einen Zahlungsauftrag – eine ausstehende Zahlung mit einer eindeutigen ID, einem Betrag und einem Ablaufzeitpunkt. Du erhältst die ID des Zahlungsauftrags per E-Mail oder über das Dashboard.
Der Befehl ruft die Details des Zahlungsauftrags ab, zeigt den Betrag und den Ablaufzeitpunkt an, fordert eine Bestätigung an und sendet anschließend die USDC-Zahlung aus deiner Keypair-Wallet.

Befehlsreferenz

Die CLI bietet mehr als 95 Befehle in 14 Kategorien. Jeder Befehl unterstützt --json für maschinenlesbare Ausgaben sowie die globalen Überschreibungen --api-key <key> und --network <net>.

Full Command Reference

Alle mehr als 95 Befehle – Kontoverwaltung, Blockchain-Abfragen, DAS API, Wallet, webhooks, Transaktionsversand, WebSockets, Staking, ZK-Komprimierung und mehr

JSON-Ausgabemodus

Füge --json zu einem beliebigen Befehl hinzu, um eine maschinenlesbare Ausgabe zu erhalten:
Beispiel:

Exit-Codes

Agenten sollten für eine zuverlässige Automatisierung die Exit-Codes prüfen:

Konfiguration

Die Konfiguration wird in ~/.helius/ gespeichert:
Verwalte die Konfiguration mit:

Auflösungsreihenfolge für API keys

API keys werden in dieser Reihenfolge aufgelöst:
  1. Flag --api-key <key> (Überschreibung pro Befehl)
  2. Umgebungsvariable HELIUS_API_KEY
  3. ~/.helius/config.json (festgelegt über helius config set-api-key)

Globale Optionen

Alle Befehle akzeptieren diese Flags:

Vollständiger Agenten-Workflow

Nächste Schritte

Agents Overview

API-Anleitungen, Workflows und Fehlerbehandlung für Agenten

Helius MCP

Verbinde KI-Tools direkt mit den APIs von Helius

View Plans

Informiere dich über die Tarife und Upgrade-Optionen von Helius

Dashboard

Überwache deine API-Nutzung und verwalte deine API keys

Support

Discord Community

Tritt unserem Discord bei, um Hilfe in Echtzeit und Unterstützung aus der Community zu erhalten

Email Support

Kontaktiere unser Support-Team direkt