Uç noktalar
Sürüm 1
Temel URL https://www.kovaragrid.com/api/public/v1. Yanıtlar JSON biçimindedir ve en fazla 10 dakika önbelleğe alınır. Her yanıt bir meta bloğu içerir; bu blokta oluşturulma zamanı, atıf ve koşullar yer alır.
GET/offerings
Sağlayıcı, GPU, bölge, sözleşme koşulları, orijinal liste fiyatı ve birimi, Kovara’nın ayrıca hesapladığı GPU-hour başına karşılaştırılabilir USD fiyatı, güven derecesi ve kontrol tarihleriyle birlikte güncel herkese açık teklifler. offering_id’ye göre sayfalanır.
| Parametre | Anlamı |
|---|
| gpu | İsteğe bağlı GPU slug’ı, örn. nvidia-h100-sxm (bkz. /gpus). |
| provider | İsteğe bağlı sağlayıcı slug’ı (bkz. /providers). |
| limit | 1–500, varsayılan 100. |
| cursor | Önceki sayfadan gelen next_cursor değeri. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Güncel herkese açık teklifleri olan her GPU için: teklif ve sağlayıcı sayıları ile GPU-hour başına karşılaştırılabilir USD fiyatının minimumu, 25. yüzdeliği, medyanı, 75. yüzdeliği ve maksimumu. İsteğe bağlı fiyatlar, tüm sözleşmelerden ayrı olarak raporlanır.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Bir teklif için yayımlanmış fiyat gözlemleri, en yenisi önce; orijinal değer ve birim, GPU-hour başına normalleştirilmiş USD fiyatının yanında, gözlem türü ve güven derecesiyle birlikte. Kaynaklar her teklifin sayfasında listelenir.
| Parametre | Anlamı |
|---|
| offering | Zorunlu offering_id, örn. OFR-0217 veya OFF000001. |
| days | 1–365, varsayılan 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
/index sayfalarının kullandığı herkese açık Compute Index genel görünümü. Resmî fixing’ler ve gösterge niteliğindeki hesaplamalar ayrı etiketlenir.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Tek bir herkese açık Compute Index serisi, GPU-hour başına USD cinsinden indirilebilir satırlar olarak: yayımlanmış fixing’ler (official_fixing, tarih başına en yüksek revizyon) ve canlı akış (indicative_tape), her zaman ayrı etiketlenir. Boş değerler boş kalır, asla sıfır olmaz. Yayımlanmış bir Referans olmayan seri bunu meta.publication_state içinde belirtir.
| Parametre | Anlamı |
|---|
| slug | Zorunlu seri slug’ı; seri sayfasında /index/ sonrasındaki kısım. |
| range | 24H, 7D, 30D veya All. Varsayılan 30D. |
| format | json (varsayılan) veya csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Bir seri için yayımlanmış fixing’ler, en yenisi önce. Her revizyon listelenir; böylece düzeltmeler, düzelttikleri değerin yanında görünür kalır ve is_latest_revision her tarih için güncel olanı işaretler. İsteğe bağlı olarak her fixing’in arkasındaki sağlayıcı bileşenlerini içerir. Yayımlanmış fixing’i olmayan bir seri, hesaplanmış bir ikame değil, boş bir liste döndürür.
| Parametre | Anlamı |
|---|
| slug | Zorunlu seri slug’ı; seri sayfasında /index/ sonrasındaki kısım. |
| limit | 1–500, varsayılan 60. |
| format | json (varsayılan) veya csv (fixing revizyonu başına bir satır). |
| include | constituents (yalnızca json): her fixing’in arkasındaki sağlayıcı bazında değerler ve gözlem kimlikleri. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
Bir Compute Index serisinin en son yayımlanmış fixing’i için gömülebilir, atıf içeren SVG kartı. Makalelerde, sunumlarda ve sağlayıcı sayfalarında kullanın; bir adayı asla referans olarak sunmaz.
| Parametre | Anlamı |
|---|
| slug | Zorunlu seri slug’ı; seri sayfasında /index/ sonrasındaki kısım. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />