GET/offerings
Актуальні публічні пропозиції з провайдером, GPU, регіоном, умовами контракту, оригінальною опублікованою ціною та одиницею, окремою порівнянною ціною Kovara в USD за GPU-hour, класом довіри та датами перевірки. Пагінація за offering_id.
| Параметр | Значення |
|---|
| gpu | Необов’язковий slug GPU, напр. nvidia-h100-sxm (див. /gpus). |
| provider | Необов’язковий slug провайдера (див. /providers). |
| limit | 1–500, за замовчуванням 100. |
| cursor | Значення next_cursor з попередньої сторінки. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
Для кожного GPU з актуальними публічними пропозиціями: кількість пропозицій і провайдерів, а також мінімум, 25-й перцентиль, медіана, 75-й перцентиль і максимум порівнянної ціни в USD за GPU-hour. On-demand наводиться окремо від усіх контрактів.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
Опубліковані цінові спостереження для однієї пропозиції, від найновіших, з оригінальним значенням і одиницею поруч із нормалізованою ціною в USD за GPU-hour, типом спостереження та класом довіри. Джерела наведено на сторінці кожної пропозиції.
| Параметр | Значення |
|---|
| offering | Обов’язковий offering_id, напр. OFR-0217 або OFF000001. |
| days | 1–365, за замовчуванням 90. |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
Публічний огляд Compute Index, що використовується на сторінках /index. Офіційні фіксинги та індикативні розрахунки позначено окремо.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
Одна публічна серія Compute Index у вигляді рядків для завантаження в USD за GPU-hour: опубліковані фіксинги (official_fixing, остання ревізія на кожну дату) і стрічка в реальному часі (indicative_tape), завжди позначені окремо. Порожні значення лишаються порожніми, ніколи не нулем. Якщо серія не є опублікованою еталонною, про це сказано в meta.publication_state.
| Параметр | Значення |
|---|
| slug | Обов’язковий slug серії — частина після /index/ на сторінці серії. |
| range | 24H, 7D, 30D або All. За замовчуванням 30D. |
| format | json (за замовчуванням) або csv. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
Опубліковані фіксинги для однієї серії, від найновіших. Наведено кожну ревізію, щоб виправлення лишалися видимими поруч зі значенням, яке вони виправляють; is_latest_revision позначає актуальну ревізію для кожної дати. За бажанням містить складники-провайдери кожного фіксингу. Серія без опублікованого фіксингу повертає порожній список, а не розраховану заміну.
| Параметр | Значення |
|---|
| slug | Обов’язковий slug серії — частина після /index/ на сторінці серії. |
| limit | 1–500, за замовчуванням 60. |
| format | json (за замовчуванням) або csv (один рядок на ревізію фіксингу). |
| include | constituents (лише json): значення за провайдерами та ідентифікатори спостережень, що лежать в основі кожного фіксингу. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
SVG-картка з атрибуцією для вбудовування, що показує останній опублікований фіксинг серії Compute Index. Використовуйте її в статтях, презентаціях і на сторінках провайдерів; вона ніколи не подає кандидата як еталон.
| Параметр | Значення |
|---|
| slug | Обов’язковий slug серії — частина після /index/ на сторінці серії. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />