Endpoints
Versie 1
Basis-URL https://www.kovaragrid.com/api/public/v1. Antwoorden zijn JSON en worden maximaal 10 minuten gecachet. Elk antwoord bevat een meta blok met het tijdstip van genereren, de bronvermelding en de voorwaarden.
GET/offerings
Actuele openbare aanbiedingen met aanbieder, GPU, regio, contractvoorwaarden, de oorspronkelijk vermelde prijs en eenheid, de afzonderlijke vergelijkbare USD per GPU-hour van Kovara, het vertrouwensniveau en de controledata. Gepagineerd op offering_id.
| Parameter | Betekenis |
|---|
| gpu | Optionele GPU-slug, bijvoorbeeld nvidia-h100-sxm (zie /gpus). |
| provider | Optionele aanbieder-slug (zie /providers). |
| limit | 1–500, standaard 100. |
| cursor | De waarde next_cursor van de vorige pagina. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Voor elke GPU met actuele openbare aanbiedingen: aantallen aanbiedingen en aanbieders, en het minimum, het 25e percentiel, de mediaan, het 75e percentiel en het maximum van de vergelijkbare USD per GPU-hour. On-demand wordt apart gerapporteerd van alle contracten.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Gepubliceerde prijsobservaties voor één aanbieding, nieuwste eerst, met de oorspronkelijke waarde en eenheid naast de genormaliseerde USD per GPU-hour, het observatietype en het vertrouwensniveau. Bronnen staan op de pagina van elke aanbieding.
| Parameter | Betekenis |
|---|
| offering | Verplichte offering_id, bijvoorbeeld OFR-0217 of OFF000001. |
| days | 1–365, standaard 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
Het openbare overzicht van de Compute Index dat de /index-pagina’s gebruiken. Officiële fixings en indicatieve berekeningen worden afzonderlijk gelabeld.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Eén openbare reeks van de Compute Index als downloadbare rijen in USD per GPU-hour: gepubliceerde fixings (official_fixing, hoogste revisie per datum) en de live tape (indicative_tape), altijd afzonderlijk gelabeld. Lege waarden blijven leeg, nooit nul. Een reeks die geen gepubliceerde referentie is, meldt dat in meta.publication_state.
| Parameter | Betekenis |
|---|
| slug | Verplichte reeks-slug, het deel na /index/ op de pagina van de reeks. |
| range | 24H, 7D, 30D of All. Standaard 30D. |
| format | json (standaard) of csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Gepubliceerde fixings voor één reeks, nieuwste eerst. Elke revisie wordt vermeld, zodat correcties zichtbaar blijven naast de waarde die ze corrigeren, en is_latest_revision markeert de actuele revisie per datum. Bevat optioneel de constituents per aanbieder achter elke fixing. Een reeks zonder gepubliceerde fixing geeft een lege lijst terug, nooit een berekend substituut.
| Parameter | Betekenis |
|---|
| slug | Verplichte reeks-slug, het deel na /index/ op de pagina van de reeks. |
| limit | 1–500, standaard 60. |
| format | json (standaard) of csv (één rij per revisie van een fixing). |
| include | constituents (alleen json): de waarden per aanbieder en de observatie-id’s achter elke fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
Insluitbare SVG-kaart met bronvermelding voor de meest recente gepubliceerde fixing van een reeks van de Compute Index. Gebruik deze in artikelen, presentaties en aanbiederspagina’s; de kaart presenteert een kandidaat nooit als referentie.
| Parameter | Betekenis |
|---|
| slug | Verplichte reeks-slug, het deel na /index/ op de pagina van de reeks. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />