> ## 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 für Agenten

> "Alles, was KI-Agenten benötigen, um mit Helius auf Solana zu bauen: programmatische Anmeldung, API-Zugriff, SDKs, MCP-Integration und empfohlene Workflows."

Helius bietet erstklassige Unterstützung für KI-Agenten, die auf Solana bauen. Von der programmatischen Kontoerstellung bis hin zu Echtzeit-Daten-Streaming können Agenten die volle Leistungsfähigkeit von Helius ohne manuelle Eingriffe nutzen.

* [Helius MCP](/docs/de/agents/mcp) — 10 geroutete Tools, die das Abfragen der Blockchain, das Senden von Transaktionen, Streaming und mehr abdecken
* [Claude Code Plugin](/docs/de/agents/claude-code-plugin) — Das erste und derzeit einzige offizielle Claude Code Plugin eines Krypto-Unternehmens. Eine Installation: MCP-Server + Skills + Referenzdateien
* [Skills](/docs/de/agents/skills/overview) — Experten-Anleitungssätze für Claude: [Build](/docs/de/agents/skills/build), [Phantom](/docs/de/agents/skills/phantom), [Jupiter](/docs/de/agents/skills/jupiter), [DFlow](/docs/de/agents/skills/dflow), [OKX](/docs/de/agents/skills/okx), [SVM](/docs/de/agents/skills/svm)
* [TypeScript SDK](/docs/de/agents/typescript-sdk) — Typgesicherte Methoden für alle Helius-APIs
* [Rust SDK](/docs/de/agents/rust-sdk) — Hochleistungsfähiges Rust SDK für Helius-APIs
* [Helius CLI](/docs/de/agents/cli) — Kontoverwaltung und Shell-Skripting

<Note>
  Eine maschinenlesbare Version dieses Abschnitts ist unter [agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt) für AI-Agent-Konsum verfügbar.
</Note>

## MCP vs CLI

Der [Helius MCP-Server](/docs/de/agents/mcp) ist der empfohlene Weg für KI-Agenten, um mit Helius zu interagieren. Er bietet 10 geroutete Tools, die KI direkten, strukturierten Zugriff auf Solana geben — keine Shell-Befehle, kein Output-Parsing, keine manuellen API-Aufrufe.

|                       | [MCP](/docs/de/agents/mcp)                                                                                                                                                                       | [CLI](/docs/de/agents/cli)                                                                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Am besten für**     | KI-Agenten in Claude Code, Cursor, Claude Desktop und jedem MCP-kompatiblen Tool                                                                                                            | Shell-Skripte, CI/CD-Pipelines, Terminal-Workflows                                      |
| **Schnittstelle**     | Strukturierte Tool-Aufrufe mit typisierten Eingaben/Ausgaben                                                                                                                                | Kommandozeile mit `--json` Ausgabe                                                      |
| **Fähigkeiten**       | 10 geroutete Tools (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …), die Blockchain-Abfragen, Transaktionen, Webhooks, Streaming, Wallet-Analyse, Dokumente und Anmeldungen abdecken | 95+ Befehle: gleiche Fähigkeiten plus Konfigurationsverwaltung und interaktive Flows    |
| **Konto Einrichtung** | Eingebaut: `heliusAccount` Aktionen `generateKeypair` → `signup` (Verlinkung oder Autopay) — keine externen Tools erforderlich                                                              | `helius keygen` → `helius signup`                                                       |
| **Wann zu verwenden** | Standardwahl für jeden KI-Agenten                                                                                                                                                           | Wenn Sie Shell-Level-Automatisierung benötigen oder kein MCP-kompatibles Tool verwenden |

<Tip>
  **Beginnen Sie mit MCP.** Wenn Ihr KI-Tool MCP unterstützt (Claude Code, Cursor, Claude Desktop, etc.), verwenden Sie den [MCP-Server](/docs/de/agents/mcp) oder das [Claude Code Plugin](/docs/de/agents/claude-code-plugin). Die CLI ist nützlich für Shell-Skripting und CI/CD, aber für KI-gesteuerte Workflows bietet MCP ein nahtloseres Erlebnis — die KI ruft Tools direkt auf, anstatt Shell-Befehle zu starten und Ausgaben zu parsen.
</Tip>

## Schnellstart: Agenten-Anmeldung

Agenten können ein Helius-Konto erstellen und einen API-Schlüssel mit der [Helius CLI](/docs/de/agents/cli) erhalten:

```bash theme={"system"}
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair

# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json

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

# Or autopay: fund the keypair with 1 USDC + ~0.001 SOL, then
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json
```

Bei Erfolg (`--resume` oder `--pay`) erhält Ihr Agent einen API-Schlüssel, RPC-Endpunkte und 1.000.000 Credits. Siehe den [vollständigen CLI-Leitfaden](/docs/de/agents/cli) für Details.

## Authentifizierung

Alle Helius API-Anfragen erfordern einen API-Schlüssel, der als Abfrageparameter übergeben wird:

```
?api-key=YOUR_API_KEY
```

Hängen Sie dies an jeden RPC- oder API-Endpunkt an. Zum Beispiel: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

Erhalten Sie einen API-Schlüssel vom [Helius Dashboard](https://dashboard.helius.dev) oder programmatisch über die [Helius CLI](/docs/de/agents/cli).

<Tip>
  **Verwenden Sie Gatekeeper für geringere Latenz** — [Gatekeeper (Beta)](/docs/de/gatekeeper/overview) entfernt Cloudflare aus dem kritischen Pfad, wodurch die Antwortzeiten um zehn bis hundert Millisekunden reduziert werden. Gleicher API-Schlüssel, gleiche Methoden — einfach den Endpunkt tauschen:

  ```
  https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  ```

  Unterstützt alle RPC, DAS, WebSocket, ZK Compression, Priority Fee und Enhanced Transaction-Methoden. Siehe den [Migrationsleitfaden](/docs/de/gatekeeper/migration-guide) für Details.
</Tip>

## Helius-spezifische API-Richtlinien

Verwenden Sie diese Helius-optimierten APIs anstelle der Verkettung von Standard-Solana-RPC-Methoden:

| Wenn Sie brauchen...                                              | Verwenden Sie dies                                                                                                     | Warum                                                                                                                                                                                  |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Gefilterte Historie, Backfill oder Token-Konto-Aktivität          | [`getTransactionsForAddress`](/docs/de/rpc/gettransactionsforaddress)                                                       | Filter und Paginierung; verwenden Sie `transactionDetails: "full"` nur, wenn rohe Transaktions- und Metadatenobjekte benötigt werden (`filters.tokenAccounts` standardmäßig zu `none`) |
| Wallet-zentrierte Aktivität mit per-Transaktions-Bilanzänderungen | [Wallet API History](/docs/de/wallet-api/history) (Beta)                                                                    | Wallet-orientierte REST-Antwort — nicht gleichwertig mit GTFA gefiltertem Backfill oder rohen vollständigen Transaktionsobjekten                                                       |
| Transfer-Level SOL/Token-Aufzeichnungen                           | [`getTransfersByAddress`](/docs/de/rpc/gettransfersbyaddress)                                                               | Normalisierte Transfers — keine vollständigen Transaktionsobjekte                                                                                                                      |
| Neue geparste menschenlesbare Historie                            | [Parsed Events](/docs/de/parsed-events)                                                                                     | Bevorzugt über veraltete [Enhanced Transactions](/docs/de/enhanced-transactions/overview); GTFA ist nicht das Enhanced Antwortformat                                                        |
| Reichhaltige Wallet-Asset-Metadaten                               | [`getAssetsByOwner`](/docs/de/api-reference/das/getassetsbyowner) (DAS API)                                                 | Gibt reiche Metadaten zurück, nicht nur rohe Token-Konten; fungible SPL/Token-2022 Bestände erfordern die methodenspezifische `showFungible` Option                                    |
| Prioritätsgebührenschätzungen                                     | [`getPriorityFeeEstimate`](/docs/de/api-reference/priority-fee/getpriorityfeeestimate)                                      | Vorgefertigte optimale Gebühren, keine manuelle Berechnung                                                                                                                             |
| Komprimierte-NFT-Transaktionshistorie                             | [`getSignaturesForAsset`](/docs/de/api-reference/das/getsignaturesforasset) (DAS API)                                       | Standardadressbasierte RPC enthält keine komprimierte-NFT-Historie                                                                                                                     |
| NFT-Suche                                                         | [`searchAssets`](/docs/de/api-reference/das/searchassets) oder [`getAssetsByGroup`](/docs/de/api-reference/das/getassetsbygroup) | Schneller, günstiger, indizierte Daten                                                                                                                                                 |
| Echtzeitdaten                                                     | [LaserStream WebSocket](/docs/de/rpc/websocket), [LaserStream gRPC](/docs/de/laserstream), oder [Webhooks](/docs/de/webhooks)         | Permanente Streams oder HTTP-Rückrufe ohne Polling                                                                                                                                     |
| Hochdurchsatz Back-End-Streaming mit Wiedergabe                   | [LaserStream gRPC Subscribe](/docs/de/api-reference/laserstream/grpc/subscribe) (SDK `subscribe`)                           | Browser/UI WSS verwendet LaserStream WebSocket; MCP `laserstreamSubscribe` generiert nur Konfiguration/Beispiele — es öffnet keinen Live-Stream                                        |
| Niedriglatenz-Transaktionseinreichung                             | [Helius Sender](/docs/de/sending-transactions/sender)                                                                       | Multi-Pfad-Routing (Helius, Jito, Harmonic, Rakurai, etc.), höhere Landungsraten                                                                                                       |

## Empfohlene Workflows

| Bauen...          | Zu verwendende Helius-Produkte                                                                                                                                                                                                                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Handelsbot        | [Gatekeeper](/docs/de/gatekeeper/overview) (niedrigste Latenz RPC) + [Sender](/docs/de/sending-transactions/sender) (schnelle Transaktionseinreichung) + [Priority Fee API](/docs/de/priority-fee-api) + [LaserStream](/docs/de/laserstream) (Echtzeitpreise)                                                                            |
| Wallet-App        | [DAS API](/docs/de/das-api) für Asset-Besitz und Metadaten + [Wallet API History](/docs/de/wallet-api/history) (Beta-Aktivität mit Bilanzänderungen) oder [`getTransactionsForAddress`](/docs/de/rpc/gettransactionsforaddress) für gefilterte Historie, Backfill, Token-Konto-Aktivität oder rohe vollständige Transaktionsobjekte |
| NFT-Marktplatz    | [DAS API](/docs/de/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhooks](/docs/de/webhooks) (Verkäufe/Listungen verfolgen)                                                                                                                                                                                                |
| Token-Sniper      | [Gatekeeper](/docs/de/gatekeeper/overview) (kantenorientiertes RPC) + [LaserStream gRPC](/docs/de/laserstream) (niedrigste Latenz) + [Sender](/docs/de/sending-transactions/sender) (gestakete Verbindungen)                                                                                                                        |
| Portfolio-Tracker | [Wallet API Balances](/docs/de/wallet-api/balances) (Beta-Portfolio-Zusammenfassungen) + [DAS API](/docs/de/das-api) (`getAssetsByOwner` mit methodenspezifischer `showFungible`) für NFT/Metadaten-Inventar                                                                                                                   |
| Wallet-Monitor    | [LaserStream WebSocket](/docs/de/rpc/websocket) oder [Webhooks](/docs/de/webhooks) für Echtzeit-Benachrichtigungen                                                                                                                                                                                                             |
| Analyse-Dashboard | [`getTransactionsForAddress`](/docs/de/rpc/gettransactionsforaddress) für gefiltertes Backfill; [Parsed Events](/docs/de/parsed-events) für neue geparste Integrationen; [Enhanced Transactions](/docs/de/enhanced-transactions/overview) nur für bestehende geparste Integrationen                                                 |
| Airdrop-Tool      | [AirShip](https://airship.helius.dev) (95% günstiger mit ZK-Komprimierung)                                                                                                                                                                                                                                           |

<Note>
  Bei Verwendung von [Wallet API Balances](/docs/de/wallet-api/balances) für Portfolio-Zusammenfassungen: Die API ist Beta; Tokens sind auf 100 pro Seite beschränkt; NFTs sind ausgeschlossen, es sei denn `showNfts=true` (maximal 100 NFTs auf der ersten Seite); `pricePerToken` und `usdValue` können null sein; Preise sind stündliche Schätzungen, keine Echtzeit-Marktpreise; `totalUsdValue` deckt die aktuelle Seite ab, nicht das gesamte paginierte Portfolio; jede Anfrage kostet 100 Credits. Verwenden Sie paginiertes DAS für vollständiges NFT-Inventar und Metadaten — behandeln Sie Balances nicht als vollständiges NFT-Inventar.
</Note>

## Schnellreferenz für Ratenlimits

Ratenlimits hängen von Ihrem [Plan](/docs/de/billing/plans) ab. Agenten beginnen mit dem Agent-Tier mit 1.000.000 Credits. Das Agent-Tier erfordert eine \$1-Zahlung, um Missbrauch zu verhindern.

| Plan          | Preis         | Monatliche Credits | RPC Ratenlimit | DAS & Enhanced APIs |
| ------------- | ------------- | ------------------ | -------------- | ------------------- |
| Agent         | \$1 Anmeldung | 1M                 | 10 Anfragen/s  | 2 Anfragen/s        |
| Entwickler    | \$49/Monat    | 10M                | 50 Anfragen/s  | 10 Anfragen/s       |
| Geschäftlich  | \$499/Monat   | 100M               | 200 Anfragen/s | 50 Anfragen/s       |
| Professionell | \$999/Monat   | 200M               | 500 Anfragen/s | 100 Anfragen/s      |

Für detaillierte Ratenlimits pro API, siehe [Rate Limits](/docs/de/billing/rate-limits).

## Credits pro API-Aufruf

| API                         | Credits | Anmerkungen                                                                                                          |
| --------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| Standard RPC-Anrufe         | 1       | Die meisten Solana RPC-Methoden                                                                                      |
| `getProgramAccounts`        | 10      | Verwenden Sie nach Möglichkeit DAS API                                                                               |
| DAS API                     | 10      | Alle DAS-Endpunkte                                                                                                   |
| Enhanced Transactions       | 100     | Geparste Transaktionsdaten                                                                                           |
| `getTransactionsForAddress` | 10+     | Volle Transaktionen kosten 10 Credits pro 100 zurückgegebenen; Signaturen-Only-Antworten kosten 10 Credits pauschal. |
| `getTransfersByAddress`     | 10      | Nur für Entwickler+ Pläne                                                                                            |
| Wallet API                  | 100     | Alle Wallet API-Endpunkte                                                                                            |
| Priority Fee API            | 1       | Gebührenabschätzung                                                                                                  |
| Sender                      | 0       | Kostenlos in allen Plänen                                                                                            |
| Webhook-Ereignisse          | 1       | Pro gelieferte Veranstaltung                                                                                         |
| Webhook-Verwaltung          | 100     | Erstellen, bearbeiten, löschen                                                                                       |

Für die vollständige Aufschlüsselung siehe [Credits](/docs/de/billing/credits).

## Wiederholungsversuche und Fehlerbehandlung

### HTTP-Statuscodes

| Code | Bedeutung         | Aktion                               |
| ---- | ----------------- | ------------------------------------ |
| 200  | Erfolg            | Antwort verarbeiten                  |
| 400  | Ungültige Anfrage | Anfrageparameter korrigieren         |
| 401  | Unbefugt          | API-Schlüssel überprüfen             |
| 429  | Ratenbegrenzung   | Zurücksetzen und erneut versuchen    |
| 5xx  | Serverfehler      | Mit exponentieller Rückoff versuchen |

### Wiederholungsmuster

```typescript theme={"system"}
async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}
```

### Kreditnutzung überwachen

```bash theme={"system"}
helius usage --json
```

## Schnellreferenz

* **Mainnet RPC**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet RPC (Gatekeeper Beta)**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Devnet RPC**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet WSS**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Mainnet WSS (Gatekeeper Beta)**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Devnet WSS**: `wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Absender-Endpunkt**: `https://sender.helius-rpc.com/fast`
* **MCP-Server**: `https://www.helius.dev/docs/mcp`
* **Dashboard**: [dashboard.helius.dev](https://dashboard.helius.dev)
* **Status**: [helius.statuspage.io](https://helius.statuspage.io)
