Points de terminaison
Version 1
URL de base https://www.kovaragrid.com/api/public/v1. Les réponses sont au format JSON et mises en cache pendant 10 minutes au maximum. Chaque réponse comprend un bloc meta contenant l’heure de génération, l’attribution et les conditions.
GET/offerings
Offres publiques actuelles avec fournisseur, GPU, région, conditions contractuelles, prix d’origine indiqué et son unité, valeur comparable distincte de Kovara en USD par GPU-hour, niveau de confiance et dates de vérification. Pagination par offering_id.
| Paramètre | Signification |
|---|
| gpu | Slug de GPU facultatif, par exemple nvidia-h100-sxm (voir /gpus). |
| provider | Slug de fournisseur facultatif (voir /providers). |
| limit | 1–500, par défaut : 100. |
| cursor | La valeur next_cursor de la page précédente. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Pour chaque GPU disposant d’offres publiques actuelles : nombre d’offres et de fournisseurs, ainsi que le minimum, le 25e percentile, la médiane, le 75e percentile et le maximum des valeurs comparables en USD par GPU-hour. L’on-demand est indiqué séparément de l’ensemble des contrats.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Observations de prix publiées pour une offre, de la plus récente à la plus ancienne, avec la valeur et l’unité d’origine à côté de la valeur normalisée en USD par GPU-hour, le type d’observation et le niveau de confiance. Les sources sont indiquées sur la page de chaque offre.
| Paramètre | Signification |
|---|
| offering | offering_id obligatoire, par exemple OFR-0217 ou OFF000001. |
| days | 1–365, par défaut : 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
La vue d’ensemble publique du Compute Index utilisée par les pages /index. Les fixings officiels et les calculs indicatifs sont étiquetés séparément.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Une série publique du Compute Index sous forme de lignes téléchargeables en USD par GPU-hour : fixings publiés (official_fixing, révision la plus élevée par date) et tape en direct (indicative_tape), toujours étiquetés séparément. Les valeurs vides restent vides, jamais zéro. Une série qui n’est pas une Référence publiée l’indique dans meta.publication_state.
| Paramètre | Signification |
|---|
| slug | Slug de la série obligatoire, la partie qui suit /index/ sur la page de la série. |
| range | 24H, 7D, 30D ou All. Par défaut : 30D. |
| format | json (par défaut) ou csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Fixings publiés pour une série, du plus récent au plus ancien. Chaque révision est listée afin que les corrections restent visibles à côté de la valeur qu’elles corrigent, et is_latest_revision indique la révision actuelle pour chaque date. Inclut en option les constituants par fournisseur à l’origine de chaque fixing. Une série sans fixing publié renvoie une liste vide, jamais un substitut calculé.
| Paramètre | Signification |
|---|
| slug | Slug de la série obligatoire, la partie qui suit /index/ sur la page de la série. |
| limit | 1–500, par défaut : 60. |
| format | json (par défaut) ou csv (une ligne par révision de fixing). |
| include | constituents (json uniquement) : les valeurs par fournisseur et les ID d’observation à l’origine de chaque fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"