Supra-Daten. Für die Integration entwickelt.

Kommerzieller Zugang, öffentliche Dokumentation

Die Supra Core-Dokumentation und die OpenAPI-Spezifikation sind öffentlich. Der API-Dienst ist kommerziell und authentifiziert: Jede Anfrage, auch health, erfordert einen gültigen API-Schlüssel mit aktiviertem Zugang. Verfügbare Tarife, zulässige Nutzung und Geschäftsbedingungen werden separat mit TCP Labs vereinbart.

Nutzen Sie den öffentlichen Vertrag, um eine Integration vor der Zugangsanfrage zu bewerten. Der Dienst ist schreibgeschützt: Er führt keine Trades aus, signiert keine Transaktionen, verwaltet keine Wallets und verwahrt keine Vermögenswerte. Bots sollten sich auf Überwachung, Analyse und Benachrichtigungen beschränken.

Schreibgeschützte Endpunkte

Alle folgenden Routen verwenden GET. FA- und Legacy-Ereignislisten bleiben getrennt; Farm-Ereignisse sind in den Antworten für Liquiditätsereignisse enthalten.

Bewahren Sie DECIMAL-Preise und -Beträge als exakte Zeichenfolgen auf. Erhalten Sie nicht verfügbare Werte und ihre Gründe; eine leere erfolgreiche Antwort ist kein Fehler. Verwenden Sie für USD-Anzeigen change_24h_usd_pct, nicht die gesonderte Änderung in der Paarwährung. Fortgeschriebene Diagrammpunkte machen einen inaktiven Markt nicht aktuell. Filter, Paginierung und Nachweisfelder stehen im Vertrag des jeweiligen Endpunkts.

Authentifizierung und erste Anfrage

Senden Sie entweder X-API-Key oder Authorization: Bearer. Bewahren Sie Dienstschlüssel im eigenen Backend auf, nicht in einem öffentlichen Browser-Bundle oder einer URL. Bei datenbankauthentifiziertem Zugang müssen Schlüssel, Kunde und Tarif aktiviert sein; Ablauf und zulässige Client-IPs werden geprüft.

Das Beispiel liest Basis-URL und Dienstschlüssel aus Ihrer lokalen Umgebung. TCP Labs liefert die Dienstadresse mit den Zugangsdaten. Diese Seite kontaktiert die API nicht.

curl --get "${SUPRA_CORE_API_BASE_URL}/api/v1/market/current" \
  --header "X-API-Key: ${SUPRA_CORE_API_KEY}" \
  --data-urlencode "network=mainnet" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0"

Erfolgreiche Antworten verwenden ok: true mit data und meta. Fehler verwenden ok: false mit einem error Objekt mit code und message. Ungültige Parameter ergeben 400, abgelehnte Authentifizierung 401, unbekannte Routen 404 und nicht unterstützte Methoden 405.

Limits und zuverlässige Anfragen

Anfragelimits gehören zum aktivierten Tarif. Der implementierte Begrenzer zählt Anfragen in festen Minuten- und UTC-Tagesfenstern je API-Schlüssel und Client-IP. Das Überschreiten eines Kontingents ergibt 429 mit RATE_LIMITED. Auch begrenzte Versuche werden gezählt; ein neues Zeitfenster startet einen neuen Zähler. Es handelt sich um Fensterkontingente, nicht um vorgeschriebene Abstände zwischen Anfragen.

burst_limit ist im aktuellen Vertrag informativ: Es ist weder ein durchgesetztes Limit gleichzeitiger Anfragen noch ein separater Burst-Zähler. Leiten Sie daraus keine zusätzliche Kapazität ab. Ein Retry-After Header ist nicht garantiert.

Vollständige API-Dokumentation lesen für alle Parameter, Beispiele und Antwortverträge.

Reduzieren Sie bei 429 die Last und wiederholen Sie später mit begrenztem Backoff und zufälliger Verzögerung. Cachen Sie gemeinsame Lesezugriffe und koordinieren Sie Worker. Wiederholen Sie ungültige Parameter oder abgelehnte Schlüssel nicht unverändert. Paginierung begrenzt Zeilen, nicht Anfragen: Markt- und Ereignislisten erlauben maximal 500 Zeilen pro Seite; Kerzen- und Diagrammrouten haben eigene dokumentierte Limits.