Päätepisteet
Versio 1
Perus-URL https://www.kovaragrid.com/api/public/v1. Vastaukset ovat JSON-muodossa ja ne tallennetaan välimuistiin enintään 10 minuutiksi. Jokainen vastaus sisältää lohkon meta (jossa on luontiaika, lähdemerkintä ja ehdot).
GET/offerings
Nykyiset julkiset tarjoomat, joissa on toimittaja, GPU, alue, sopimusehdot, alkuperäinen ilmoitettu hinta ja yksikkö, Kovara-alustan erillinen vertailukelpoinen hinta (USD per GPU-hour), luottamusluokka ja tarkistuspäivät. Sivutus perustuu kenttään offering_id.
| Parametri | Merkitys |
|---|
| gpu | Valinnainen GPU-slug, esim. nvidia-h100-sxm (katso /gpus). |
| provider | Valinnainen toimittajan slug (katso /providers). |
| limit | 1–500, oletus 100. |
| cursor | Edellisen sivun next_cursor-arvo. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Jokaiselle GPU:lle, jolla on nykyisiä julkisia tarjoomia: tarjoomien ja toimittajien määrät sekä vertailukelpoisen hinnan (USD per GPU-hour) minimi, 25. persentiili, mediaani, 75. persentiili ja maksimi. On-demand raportoidaan erillään kaikista sopimuksista.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Yhden tarjooman julkaistut hintahavainnot uusimmasta alkaen: alkuperäinen arvo ja yksikkö normalisoidun arvon (USD per GPU-hour) vieressä, havaintotyyppi ja luottamusluokka. Lähteet on lueteltu kunkin tarjooman sivulla.
| Parametri | Merkitys |
|---|
| offering | Pakollinen offering_id, esim. OFR-0217 tai OFF000001. |
| days | 1–365, oletus 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
Julkinen Compute Index -yleiskatsaus, jota /index-sivut käyttävät. Viralliset fixingit ja suuntaa-antavat laskelmat on merkitty erikseen.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Yksi julkinen Compute Index -sarja ladattavina riveinä (USD per GPU-hour): julkaistut fixingit (official_fixing, korkein revisio päivää kohti) ja reaaliaikainen tape (indicative_tape), aina erikseen merkittyinä. Tyhjät arvot pysyvät tyhjinä, ei koskaan nollana. Sarja, joka ei ole julkaistu viite, ilmoittaa sen kentässä meta.publication_state.
| Parametri | Merkitys |
|---|
| slug | Pakollinen sarjan slug eli sarjan sivulla polun /index/ jälkeen tuleva osa. |
| range | 24H, 7D, 30D tai All. Oletus 30D. |
| format | json (oletus) tai csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Yhden sarjan julkaistut fixingit uusimmasta alkaen. Jokainen revisio on lueteltu, jotta korjaukset pysyvät näkyvissä korjaamansa arvon vieressä, ja is_latest_revision merkitsee kunkin päivän voimassa olevan revision. Mukaan voi halutessa sisällyttää kunkin fixingin taustalla olevat toimittajakomponentit. Sarja, jolla ei ole julkaistua fixingiä, palauttaa tyhjän luettelon, ei koskaan laskettua korviketta.
| Parametri | Merkitys |
|---|
| slug | Pakollinen sarjan slug eli sarjan sivulla polun /index/ jälkeen tuleva osa. |
| limit | 1–500, oletus 60. |
| format | json (oletus) tai csv (yksi rivi fixing-revisiota kohti). |
| include | constituents (vain json): toimittajakohtaiset arvot ja havaintojen ID:t kunkin fixingin taustalla. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"