Endpoints
Versión 1
URL base https://www.kovaragrid.com/api/public/v1. Las respuestas son JSON y se almacenan en caché durante un máximo de 10 minutos. Cada respuesta incluye un bloque meta con la hora de generación, la atribución y los términos.
GET/offerings
Ofertas públicas actuales con proveedor, GPU, región, condiciones contractuales, el precio original publicado y su unidad, el valor comparable de Kovara, por separado, en USD por GPU-hour, el nivel de confianza y las fechas de comprobación. Paginado por offering_id.
| Parámetro | Significado |
|---|
| gpu | Slug de GPU opcional, p. ej. nvidia-h100-sxm (consulta /gpus). |
| provider | Slug de proveedor opcional (consulta /providers). |
| limit | 1–500, por defecto 100. |
| cursor | El valor de next_cursor de la página anterior. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Para cada GPU con ofertas públicas actuales: número de ofertas y de proveedores, y los valores comparables en USD por GPU-hour: mínimo, percentil 25, mediana, percentil 75 y máximo. El on-demand se presenta por separado de todos los contratos.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Observaciones de precios publicadas de una oferta, empezando por las más recientes, con el valor original y su unidad junto al valor normalizado en USD por GPU-hour, el tipo de observación y el nivel de confianza. Las fuentes figuran en la página de cada oferta.
| Parámetro | Significado |
|---|
| offering | offering_id obligatorio, p. ej. OFR-0217 u OFF000001. |
| days | 1–365, por defecto 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
El resumen público del Compute Index que usan las páginas /index. Los fixings oficiales y los cálculos indicativos se etiquetan por separado.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Una serie pública del Compute Index en forma de filas descargables en USD por GPU-hour: los fixings publicados (official_fixing, la revisión más alta por fecha) y la cinta en vivo (indicative_tape), siempre etiquetados por separado. Los valores vacíos permanecen vacíos, nunca cero. Una serie que no es una Referencia publicada lo indica en meta.publication_state.
| Parámetro | Significado |
|---|
| slug | Slug de serie obligatorio, la parte que sigue a /index/ en la página de la serie. |
| range | 24H, 7D, 30D o All. Por defecto 30D. |
| format | json (por defecto) o csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Fixings publicados de una serie, empezando por los más recientes. Se enumera cada revisión para que las correcciones sigan visibles junto al valor que corrigen; is_latest_revision señala la revisión vigente de cada fecha. De forma opcional incluye los constituyentes por proveedor que hay detrás de cada fixing. Una serie sin ningún fixing publicado devuelve una lista vacía, nunca un sustituto calculado.
| Parámetro | Significado |
|---|
| slug | Slug de serie obligatorio, la parte que sigue a /index/ en la página de la serie. |
| limit | 1–500, por defecto 60. |
| format | json (por defecto) o csv (una fila por revisión de fixing). |
| include | constituents (solo json): los valores por proveedor y los ID de observación que hay detrás de cada fixing. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"