Endpoint
Versione 1
URL di base https://www.kovaragrid.com/api/public/v1. Le risposte sono in JSON e vengono messe in cache per un massimo di 10 minuti. Ogni risposta include un blocco meta con l’ora di generazione, l’attribuzione e i termini.
GET/offerings
Offerte pubbliche attuali con provider, GPU, regione, condizioni contrattuali, prezzo originale indicato e relativa unità, il valore comparabile separato di Kovara in USD per GPU-hour, grado di confidenza e date di verifica. Paginato per offering_id.
| Parametro | Significato |
|---|
| gpu | Slug GPU facoltativo, ad es. nvidia-h100-sxm (vedi /gpus). |
| provider | Slug del provider facoltativo (vedi /providers). |
| limit | 1–500, predefinito 100. |
| cursor | Il valore next_cursor della pagina precedente. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Per ogni GPU con offerte pubbliche attuali: numero di offerte e di provider e valori comparabili in USD per GPU-hour: minimo, 25° percentile, mediana, 75° percentile e massimo. L’on-demand è riportato separatamente rispetto a tutti i contratti.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Osservazioni di prezzo pubblicate per una singola offerta, dalla più recente, con il valore originale e la relativa unità accanto al valore normalizzato in USD per GPU-hour, il tipo di osservazione e il grado di confidenza. Le fonti sono elencate nella pagina di ciascuna offerta.
| Parametro | Significato |
|---|
| offering | offering_id obbligatorio, ad es. OFR-0217 o OFF000001. |
| days | 1–365, predefinito 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
La panoramica pubblica del Compute Index usata dalle pagine /index. I fixing ufficiali e i calcoli indicativi sono etichettati separatamente.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Una serie pubblica del Compute Index in forma di righe scaricabili in USD per GPU-hour: i fixing pubblicati (official_fixing, revisione più alta per data) e il tape live (indicative_tape), sempre etichettati separatamente. I valori vuoti restano vuoti, mai zero. Una serie che non è un Reference pubblicato lo dichiara in meta.publication_state.
| Parametro | Significato |
|---|
| slug | Slug della serie obbligatorio, la parte dopo /index/ nella pagina della serie. |
| range | 24H, 7D, 30D o All. Predefinito 30D. |
| format | json (predefinito) o csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Fixing pubblicati per una serie, dal più recente. Ogni revisione è elencata, così le correzioni restano visibili accanto al valore che correggono, e is_latest_revision indica quella corrente per ciascuna data. Include facoltativamente i costituenti provider alla base di ciascun fixing. Una serie senza fixing pubblicati restituisce un elenco vuoto, mai un sostituto calcolato.
| Parametro | Significato |
|---|
| slug | Slug della serie obbligatorio, la parte dopo /index/ nella pagina della serie. |
| limit | 1–500, predefinito 60. |
| format | json (predefinito) o csv (una riga per revisione di fixing). |
| include | constituents (solo json): i valori per provider e gli ID delle osservazioni alla base di ciascun fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"