> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Helius CLI

> Befehlszeilenschnittstelle für Helius mit mehr als 95 Befehlen für Kontoverwaltung, Solana-Abfragen, Transaktionsversand, Webhooks, Streaming und Staking-Automatisierung.

Die [Helius CLI](https://www.npmjs.com/package/helius-cli) ist eine umfassende Befehlszeilenschnittstelle für die Helius-Plattform. Sie bietet mehr als 95 Befehle für Kontoverwaltung, Blockchain-Datenabfragen, Transaktionsversand, Webhooks, Echtzeit-Streaming, Staking, ZK-Kompression und mehr — mit maschinenlesbarem JSON-Output für jeden Befehl.

<Tip>
  **Verwenden Sie ein MCP-kompatibles AI-Tool?** Der [Helius MCP-Server](/docs/de/agents/mcp) ist der empfohlene Weg für AI-Agenten, um mit Helius zu interagieren — er bietet 10 Routing-Tools mit strukturierten Eingaben/Ausgaben, einschließlich integriertem Kontoanmeldung. Verwenden Sie die CLI für Shell-Skripte, CI/CD-Pipelines oder wenn MCP nicht verfügbar ist.
</Tip>

## Installation

```bash theme={"system"}
npm install -g helius-cli
```

## Schnelleinstieg — Bestehende Benutzer

Wenn Sie bereits einen Helius API-Schlüssel besitzen, setzen Sie ihn einfach und los geht's:

```bash theme={"system"}
helius config set-api-key YOUR_API_KEY
```

Holen Sie Ihren Schlüssel von [dashboard.helius.dev](https://dashboard.helius.dev). Das war's — überspringen Sie die folgenden Anmeldeschritte.

## Schnelleinstieg — Neue Benutzer

<Note>
  Kontoerstellende `helius signup` Aufrufe erfordern `--email`, `--first-name` und `--last-name` — einschließlich des Agentenplans. `helius signup --resume`, das eine bestehende Anmeldung nach der Zahlung über den gehosteten Link abschließt, benötigt keine weiteren Flags.
</Note>

<Steps>
  <Step title="Ein Schlüsselpaar generieren">
    ```bash theme={"system"}
    helius keygen
    ```

    Ausgabe:

    ```
    ✓ Keypair generated
    Path: ~/.helius/keypair.json
    Address: 7xKp...3nQm

    To use this wallet, fund it with:
      • ~0.001 SOL for transaction fees
      • 1 USDC for Helius signup
    ```

    Der obige Zahlungshinweis gilt nur, wenn Sie Autopay verwenden — überspringen Sie die Finanzierung, wenn Sie über den gehosteten Link zahlen möchten.
  </Step>

  <Step title="Konto erstellen">
    Zwei Zahlungsmethoden: gehosteter Link (von jeder Wallet zahlen, nichts zu finanzieren) oder Autopay (USDC vom lokalen Schlüsselpaar zahlen, das \~0.001 SOL + den Planbetrag halten muss).

    ```bash theme={"system"}
    # Default: print a hosted payment link, pay with any wallet in the browser
    helius signup --email you@example.com --first-name Jane --last-name Doe

    # After paying via link, finalize the account
    helius signup --resume

    # Or autopay from the local keypair
    helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe
    ```
  </Step>

  <Step title="Ihre API-Schlüssel und Endpunkte erhalten">
    ```bash theme={"system"}
    helius projects
    helius apikeys <project-id>
    helius rpc <project-id>
    ```
  </Step>
</Steps>

<Warning>
  Ihr API-Schlüssel ist vertrauliche Information, die Zugriff auf Ihr Helius-Konto gewährt. Geben Sie ihn niemals im Client-seitigen Code, in öffentlichen Repos oder in browserzugänglichen Bereichen preis.
</Warning>

## Pläne & Preise

Sie können jeden geteilten Helius-Plan direkt über die CLI erwerben. Übergeben Sie `--plan` während der Anmeldung oder verwenden Sie `helius upgrade` später:

| Plan          | Preis        | Credits     | `--plan` Wert  |
| ------------- | ------------ | ----------- | -------------- |
| Agent         | \$1 einmalig | 1,000,000   | `agent`        |
| Entwickler    | \$49/Monat   | 10,000,000  | `developer`    |
| Geschäft      | \$499/Monat  | 100,000,000 | `business`     |
| Professionell | \$999/Monat  | 200,000,000 | `professional` |

<Note>
  Der **Agent**-Plan (`agent`) ist der Standard. Er kostet \$1 (zahlbar in USDC), um Missbrauch zu verhindern, und gibt Ihnen 1.000.000 Credits. Für höhere Ratenbeschränkungen und mehr Credits melden Sie sich mit einem kostenpflichtigen Plan an oder aktualisieren Sie später.
</Note>

### Anmeldung mit einem bestimmten Plan

```bash theme={"system"}
# Default: Agent plan ($1)
helius signup --email you@example.com --first-name Jane --last-name Doe

# Developer plan ($49/mo)
helius signup --plan developer --email you@example.com --first-name Jane --last-name Doe

# Yearly billing (paid plans only)
helius signup --plan business --period yearly --email you@example.com --first-name Jane --last-name Doe
```

### Ein bestehendes Konto aktualisieren

```bash theme={"system"}
helius upgrade --plan developer --email you@example.com --first-name Jane --last-name Doe
```

### Eine Verlängerung bezahlen

Wenn eine Abonnementverlängerung fällig ist (monatlich oder jährlich), erstellt Helius eine **Zahlungsabsicht** — eine ausstehende Zahlung mit einer eindeutigen ID, einem Betrag und einem Ablaufdatum. Sie erhalten die Zahlungsabsicht-ID per E-Mail oder über das [Dashboard](https://dashboard.helius.dev).

```bash theme={"system"}
helius pay <payment-intent-id>
```

Der Befehl ruft die Absichtsdaten ab, zeigt Betrag und Ablaufdatum an, fordert eine Bestätigung an und sendet dann die USDC-Zahlung von Ihrer Schlüsselpaar-Wallet.

## Befehlsreferenz

Die CLI bietet über 95 Befehle in 14 Kategorien. Jeder Befehl unterstützt `--json` für maschinenlesbaren Output und `--api-key <key>` / `--network <net>` globale Überschreibungen.

<Card title="Komplette Befehlsreferenz" icon="terminal" href="/docs/de/agents/cli/commands">
  Alle über 95 Befehle — Kontoverwaltung, Blockchain-Abfragen, DAS API, Wallet, Webhooks, Transaktionsversand, WebSockets, Staking, ZK-Kompression und mehr
</Card>

## JSON-Ausgabemodus

Fügen Sie `--json` zu jedem Befehl für maschinenlesbaren Output hinzu:

```bash theme={"system"}
helius projects --json
helius balance Gh9ZwEm... --json
helius asset owner 86xCnPe... --json
```

Beispiel:

```json theme={"system"}
{
  "projects": [
    {
      "id": "67b9d260-726b-4ba3-8bb0-dbbf794641bf",
      "name": "My Project",
      "plan": "free"
    }
  ]
}
```

## Exit-Codes

Agenten sollten Exit-Codes zur zuverlässigen Automatisierung überprüfen:

| Code | Bedeutung                    |
| ---- | ---------------------------- |
| 0    | Erfolg                       |
| 1    | Allgemeiner Fehler           |
| 10   | Nicht eingeloggt             |
| 11   | Schlüsselpaar nicht gefunden |
| 20   | Unzureichendes SOL           |
| 21   | Unzureichendes USDC          |
| 30   | Keine Projekte gefunden      |
| 31   | Projekt nicht gefunden       |
| 40   | API-Fehler                   |

## Konfiguration

Die Konfiguration wird in `~/.helius/` gespeichert:

```
~/.helius/
├── config.json    # JWT token, API key, network, default project
└── keypair.json   # Solana keypair (if generated with keygen)
```

Konfiguration verwalten mit:

```bash theme={"system"}
helius config show              # View current config
helius config set-api-key <key> # Set API key
helius config set-network devnet # Switch to devnet
helius config set-project <id>  # Set default project
helius config clear             # Reset everything
```

### Reihenfolge der API-Schlüsselauflösung

Die API-Schlüssel werden in dieser Reihenfolge aufgelöst:

1. `--api-key <key>` Flag (pro-Befehl-Überschreibung)
2. `HELIUS_API_KEY` Umgebungsvariable
3. `~/.helius/config.json` (eingestellt über `helius config set-api-key`)

## Globale Optionen

Alle Befehle akzeptieren diese Flags:

| Flag                   | Beschreibung                                                        |
| ---------------------- | ------------------------------------------------------------------- |
| `--api-key <key>`      | Den konfigurierten API-Schlüssel überschreiben                      |
| `--network <net>`      | Das Netzwerk überschreiben (`mainnet` oder `devnet`)                |
| `--json`               | Ausgabe im JSON-Format                                              |
| `-k, --keypair <path>` | Pfad zur Schlüsselpaar-Datei (Befehle, die eine Signatur erfordern) |

## Vollständiger Agenten-Workflow

```bash theme={"system"}
# Step 1: Generate keypair
helius keygen

# Step 2: Create account (default: hosted payment link, pay from any wallet)
helius signup --email you@example.com --first-name Jane --last-name Doe
helius signup --resume   # Finalize after paying via link
# Or autopay from the local keypair (requires ~0.001 SOL + plan USDC):
# helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

# Step 3: Get API keys
helius projects
helius apikeys <project-id>

# Step 4: Get RPC endpoints
helius rpc <project-id>

# Step 5: Start querying
helius balance <address>
helius asset owner <wallet-address>
helius tx history <address> --limit 10
```

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Agentenübersicht" icon="robot" href="/docs/de/agents/overview">
    API-Anleitung, Workflows und Fehlerbehandlung für Agenten
  </Card>

  <Card title="Helius MCP" icon="plug" href="/docs/de/agents/mcp">
    Verbinden Sie AI-Tools direkt mit Helius-APIs
  </Card>

  <Card title="Pläne anzeigen" icon="credit-card" href="/docs/de/billing/plans">
    Verstehen Sie Helius-Pläne und Upgrade-Optionen
  </Card>

  <Card title="Dashboard" icon="chart-line" href="https://dashboard.helius.dev">
    Überwachen Sie Ihre API-Nutzung und verwalten Sie Schlüssel
  </Card>
</CardGroup>

## Support

<CardGroup cols={2}>
  <Card title="Discord Community" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    Treten Sie unserem Discord bei für Echtzeit-Hilfe und Community-Support
  </Card>

  <Card title="E-Mail-Support" icon="envelope" href="mailto:support@helius.xyz">
    Kontaktieren Sie direkt unser Support-Team
  </Card>
</CardGroup>