GET/offerings
Ofertas públicas atuais com provedor, GPU, região, condições contratuais, o preço anunciado original e a unidade, o valor comparável separado da Kovara em USD por GPU-hour, nível de confiança e datas de verificação. Paginado por offering_id.
| Parâmetro | Significado |
|---|
| gpu | Slug opcional da GPU, por exemplo nvidia-h100-sxm (veja /gpus). |
| provider | Slug opcional do provedor (veja /providers). |
| limit | 1–500, padrão 100. |
| cursor | O valor next_cursor da página anterior. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Para cada GPU com ofertas públicas atuais: contagem de ofertas e de provedores, e o mínimo, o percentil 25, a mediana, o percentil 75 e o máximo comparáveis em USD por GPU-hour. On-demand é informado separadamente de todos os contratos.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Observações de preço publicadas para uma oferta, das mais recentes para as mais antigas, com o valor original e a unidade ao lado do valor normalizado em USD por GPU-hour, o tipo de observação e o nível de confiança. As fontes estão listadas na página de cada oferta.
| Parâmetro | Significado |
|---|
| offering | offering_id obrigatório, por exemplo OFR-0217 ou OFF000001. |
| days | 1–365, padrão 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
A visão geral pública do Compute Index usada pelas páginas /index. Fixings oficiais e cálculos indicativos são identificados separadamente.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Uma série pública do Compute Index em linhas para download em USD por GPU-hour: fixings publicados (official_fixing, revisão mais alta por data) e o tape ao vivo (indicative_tape), sempre identificados separadamente. Valores vazios continuam vazios, nunca zero. Uma série que não é uma Referência publicada informa isso em meta.publication_state.
| Parâmetro | Significado |
|---|
| slug | Slug obrigatório da série, a parte depois de /index/ na página da série. |
| range | 24H, 7D, 30D ou All. Padrão 30D. |
| format | json (padrão) ou csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Fixings publicados de uma série, dos mais recentes para os mais antigos. Todas as revisões são listadas, para que as correções continuem visíveis ao lado do valor que corrigem, e is_latest_revision marca a atual de cada data. Opcionalmente inclui os constituintes de provedores por trás de cada fixing. Uma série sem fixing publicado retorna uma lista vazia, nunca um substituto calculado.
| Parâmetro | Significado |
|---|
| slug | Slug obrigatório da série, a parte depois de /index/ na página da série. |
| limit | 1–500, padrão 60. |
| format | json (padrão) ou csv (uma linha por revisão de fixing). |
| include | constituents (somente json): os valores por provedor e os ids de observação por trás de cada fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
Cartão SVG incorporável e com atribuição para o fixing publicado mais recente de uma série do Compute Index. Use em artigos, apresentações e páginas de provedores; ele nunca apresenta uma candidata como referência.
| Parâmetro | Significado |
|---|
| slug | Slug obrigatório da série, a parte depois de /index/ na página da série. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />