Punkty końcowe
Wersja 1
Bazowy URL https://www.kovaragrid.com/api/public/v1. Odpowiedzi są w formacie JSON i są buforowane do 10 minut. Każda odpowiedź zawiera blok meta z czasem wygenerowania, informacją o źródle i warunkami.
GET/offerings
Bieżące publiczne oferty z dostawcą, GPU, regionem, warunkami umowy, oryginalną ceną katalogową i jednostką, odrębną porównywalną ceną Kovara w USD za GPU-hour, oceną pewności i datami sprawdzenia. Stronicowane według offering_id.
| Parametr | Znaczenie |
|---|
| gpu | Opcjonalny slug GPU, np. nvidia-h100-sxm (zob. /gpus). |
| provider | Opcjonalny slug dostawcy (zob. /providers). |
| limit | 1–500, domyślnie 100. |
| cursor | Wartość next_cursor z poprzedniej strony. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Dla każdego GPU z bieżącymi ofertami publicznymi: liczba ofert i dostawców oraz minimum, 25. percentyl, mediana, 75. percentyl i maksimum porównywalnej ceny w USD za GPU-hour. Ceny on-demand są podawane oddzielnie od wszystkich umów.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Opublikowane obserwacje cen dla jednej oferty, od najnowszych, z wartością oryginalną i jednostką obok znormalizowanej ceny w USD za GPU-hour, typem obserwacji i oceną pewności. Źródła są wymienione na stronie każdej oferty.
| Parametr | Znaczenie |
|---|
| offering | Wymagany offering_id, np. OFR-0217 lub OFF000001. |
| days | 1–365, domyślnie 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
Publiczny przegląd Compute Index używany przez strony /index. Oficjalne fixingi i obliczenia orientacyjne są oznaczone oddzielnie.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Jedna publiczna seria Compute Index jako wiersze do pobrania w USD za GPU-hour: opublikowane fixingi (official_fixing, najwyższa rewizja dla każdej daty) i taśma na żywo (indicative_tape), zawsze oznaczone oddzielnie. Puste wartości pozostają puste, nigdy zerowe. Seria, która nie jest opublikowanym wskaźnikiem referencyjnym, informuje o tym w meta.publication_state.
| Parametr | Znaczenie |
|---|
| slug | Wymagany slug serii, czyli część po /index/ na stronie serii. |
| range | 24H, 7D, 30D lub All. Domyślnie 30D. |
| format | json (domyślnie) lub csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Opublikowane fixingi dla jednej serii, od najnowszych. Każda rewizja jest wymieniona, aby korekty pozostawały widoczne obok wartości, którą korygują, a is_latest_revision oznacza bieżącą rewizję dla każdej daty. Opcjonalnie zawiera składniki dostawców stojące za każdym fixingiem. Seria bez opublikowanego fixingu zwraca pustą listę, nigdy obliczony zamiennik.
| Parametr | Znaczenie |
|---|
| slug | Wymagany slug serii, czyli część po /index/ na stronie serii. |
| limit | 1–500, domyślnie 60. |
| format | json (domyślnie) lub csv (jeden wiersz na rewizję fixingu). |
| include | constituents (tylko json): wartości dla poszczególnych dostawców i identyfikatory obserwacji stojące za każdym fixingiem. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
Osadzalna karta SVG z podaniem źródła dla najnowszego opublikowanego fixingu serii Compute Index. Używaj jej w artykułach, prezentacjach i na stronach dostawców; nigdy nie przedstawia kandydata jako wskaźnika referencyjnego.
| Parametr | Znaczenie |
|---|
| slug | Wymagany slug serii, czyli część po /index/ na stronie serii. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />