Zum Hauptinhalt springen
Die Helius API verwendet API keys, um requests zu authentifizieren. Jeder API-request muss deinen API key enthalten, um deine Identität und Berechtigungen zu überprüfen.
Dein API key ist eine vertrauliche Information, die Zugriff auf dein Helius-Konto gewährt. Gib ihn niemals in clientseitigem Code, öffentlichen Repositorys oder über den Browser zugänglichen Bereichen preis.

Erste Schritte

1. Erstelle deinen API key

1

Sign up or log in

Erstelle im Helius Dashboard ein Konto oder melde dich bei deinem bestehenden Konto an.
2

Navigate to API Keys

Öffne in der Seitenleiste deines Dashboards den Bereich API Keys.
3

Generate a new key

Klicke auf Create New API Key und gib einen aussagekräftigen Namen für dein Projekt an (z. B. „Produktions-App“, „Entwicklungsumgebung“).
4

Copy and secure your key

Kopiere deinen API key sofort und bewahre ihn sicher auf. Sobald du die Seite verlässt, kannst du ihn nicht mehr anzeigen.

2. Verwende deinen API key

Füge deinen API key in allen requests als Abfrageparameter ein:

Erste Schritte (für Agenten)

Agenten können sich über die Helius CLI programmgesteuert für Helius-Konten registrieren, Projekte erstellen und API keys generieren. Die vollständige Anleitung findest du unter: https://dashboard.helius.dev/agents.md

Installiere die Helius CLI

Generiere ein Schlüsselpaar

Fülle das generierte Wallet auf (nur Autopay)

Überspringe diesen Schritt, wenn du über den gehosteten Zahlungslink bezahlst. Dies ist der standardmäßige Registrierungsmodus, der mit helius signup --resume abgeschlossen wird. Autopay (--pay) bezahlt über das lokale Schlüsselpaar: Sende den Tarifbetrag in USDC (10 $ für den Agent-Tarif) und etwa 0,001 SOL an die Wallet-Adresse aus dem vorherigen Schritt.

Registriere dich und erhalte einen API key

Für jede neue Registrierung sind --email, --first-name und --last-name erforderlich. Das gilt auch für den Agent-Tarif. Die Wallet wird nur zum Bezahlen verwendet.

Best Practices für Sicherheit

Environment Variables

Speichere deinen API key in Umgebungsvariablen, nicht in deinem Quellcode.

IP Restrictions

Richte im Dashboard IP-Beschränkungen für deine API keys ein, um den Zugriff auf bestimmte IP-Adressen oder Adressbereiche zu begrenzen.

Separate Keys

Verwende unterschiedliche API keys für Entwicklungs-, Staging- und Produktionsumgebungen. So trennst du die Nutzung und verbesserst die Sicherheit.

Monitor Usage

Prüfe deine API-Nutzung regelmäßig im Dashboard, um ungewöhnliche Muster oder potenzielle Sicherheitsprobleme zu erkennen.

Verwaltung von Geheimnissen

Rate Limits und Nutzung

Rate Limits variieren je nach Abonnement. Überwache deine Nutzung im Helius Dashboard, damit du innerhalb der dir zugewiesenen Limits bleibst.

Rate Limits verstehen

  • Requests pro Sekunde: Abhängig von deinem Abonnement
  • Monatliches Request-Kontingent: Gesamtzahl der pro Abrechnungszeitraum zulässigen Requests
  • Kurzzeitige Überschreitung: Kurzzeitige Spitzen oberhalb deines grundlegenden Rate Limit

Mit Rate Limits umgehen

Fehlerbehebung

Symptome: Fehler 401 Unauthorized oder „Invalid API Key“Lösungen:
  • Prüfe, ob dein API key korrekt ist und nicht neu generiert wurde
  • Prüfe, ob du den API key als Abfrageparameter angibst: ?api-key=YOUR_KEY
  • Stelle sicher, dass dein API key keine zusätzlichen Leerzeichen oder Zeichen enthält
  • Vergewissere dich, dass dein API key nicht abgelaufen oder widerrufen wurde
Symptome: Fehler 429 Too Many RequestsLösungen:
  • Prüfe deine aktuelle Nutzung im Dashboard
  • Implementiere exponentielles Backoff in deiner Wiederholungslogik
  • Erwäge ein Upgrade deines Tarifs für höhere Limits
  • Optimiere deine Requests, um unnötige Aufrufe zu reduzieren
Symptome: Fehler 403 ForbiddenLösungen:
  • Prüfe, ob IP-Beschränkungen deine Requests blockieren
  • Prüfe, ob dein Abonnement den Zugriff auf den endpoint umfasst
  • Stelle sicher, dass dein API key über die erforderlichen Berechtigungen verfügt

Nächste Schritte

Quickstart Guide

Sende deine ersten API-Aufrufe mit Helius

API Reference

Entdecke alle verfügbaren endpoints und Methoden

Rate Limits

Informiere dich über Rate Limits und Upgrade-Optionen

Dashboard

Überwache deine API-Nutzung und verwalte deine API keys

Support

Brauchst du Hilfe bei der Authentifizierung oder hast du Fragen zu API keys?

Discord Community

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

Email Support

Kontaktiere direkt unser Support-Team