Endpunkte
Version 1
Basis-URL https://www.kovaragrid.com/api/public/v1. Die Antworten liegen als JSON vor und werden bis zu 10 Minuten im Cache gehalten. Jede Antwort enthält einen meta Block mit dem Zeitpunkt der Erstellung, der Quellenangabe und den Bedingungen.
GET/offerings
Aktuelle öffentliche Angebote mit Anbieter, GPU, Region, Vertragsbedingungen, dem gelisteten Originalpreis samt Einheit, dem separaten Vergleichspreis von Kovara in USD pro GPU-hour, Konfidenzgrad und Datumsangaben zur Prüfung. Paginierung nach offering_id.
| Parameter | Bedeutung |
|---|
| gpu | Optionaler GPU-Slug, z. B. nvidia-h100-sxm (siehe /gpus). |
| provider | Optionaler Anbieter-Slug (siehe /providers). |
| limit | 1–500, Standardwert 100. |
| cursor | Der Wert von next_cursor von der vorherigen Seite. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Für jede GPU mit aktuellen öffentlichen Angeboten: Anzahl der Angebote und Anbieter sowie Minimum, 25. Perzentil, Median, 75. Perzentil und Maximum der Vergleichspreise in USD pro GPU-hour. On-Demand wird getrennt von allen Verträgen ausgewiesen.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Veröffentlichte Preisbeobachtungen für ein Angebot, die neuesten zuerst, mit dem Originalwert samt Einheit neben den normalisierten USD pro GPU-hour, der Beobachtungsart und dem Konfidenzgrad. Die Quellen sind auf der Seite des jeweiligen Angebots aufgeführt.
| Parameter | Bedeutung |
|---|
| offering | Erforderliche offering_id, z. B. OFR-0217 oder OFF000001. |
| days | 1–365, Standardwert 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
Die öffentliche Übersicht des Compute Index, die von den /index-Seiten verwendet wird. Offizielle Fixings und indikative Berechnungen werden getrennt gekennzeichnet.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Eine öffentliche Serie des Compute Index als herunterladbare Zeilen in USD pro GPU-hour: veröffentlichte Fixings (official_fixing, höchste Revision je Datum) und das Live-Tape (indicative_tape), stets getrennt gekennzeichnet. Leere Werte bleiben leer, nie null. Eine Serie, die keine veröffentlichte Referenz ist, weist in meta.publication_state darauf hin.
| Parameter | Bedeutung |
|---|
| slug | Erforderlicher Serien-Slug, der Teil nach /index/ auf der Serienseite. |
| range | 24H, 7D, 30D oder All. Standardwert 30D. |
| format | json (Standardwert) oder csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Veröffentlichte Fixings für eine Serie, die neuesten zuerst. Jede Revision wird aufgeführt, damit Korrekturen neben dem Wert sichtbar bleiben, den sie korrigieren; is_latest_revision kennzeichnet für jedes Datum die aktuelle. Optional werden die Anbieter-Konstituenten hinter jedem Fixing eingeschlossen. Eine Serie ohne veröffentlichtes Fixing liefert eine leere Liste zurück, niemals einen berechneten Ersatz.
| Parameter | Bedeutung |
|---|
| slug | Erforderlicher Serien-Slug, der Teil nach /index/ auf der Serienseite. |
| limit | 1–500, Standardwert 60. |
| format | json (Standardwert) oder csv (eine Zeile pro Fixing-Revision). |
| include | constituents (nur json): die Werte je Anbieter und die Beobachtungs-IDs hinter jedem Fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"