Loading
译自英文。如有差异，以英文版本为准。
公开数据 API
免费、只读的 JSON API，基于与网站所示相同的公开记录。无需密钥。
端点
基础 URL https://www.kovaragrid.com/api/public/v1。响应为 JSON 格式，最多缓存 10 分钟。每个响应都包含一个 meta 块，其中包含生成时间、署名和条款。
/offerings当前公开的产品，包括服务商、GPU、区域、合同条款、原始标价和单位、Kovara 单独计算的可比 USD / GPU-hour 价格、置信度等级和核查日期。按 offering_id 分页。
| 参数 | 含义 |
|---|---|
| gpu | 可选的 GPU slug，例如 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"
/gpu-prices针对每款有当前公开产品的 GPU：产品数和服务商数，以及可比 USD / GPU-hour 价格的最小值、第 25 百分位、中位数、第 75 百分位和最大值。按需价格与所有合同类型分开报告。
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
/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"
/indices/index 页面使用的公开 Compute Index 概览。官方定盘价和参考性计算分别标注。
curl "https://www.kovaragrid.com/api/public/v1/indices"
/indices/{slug}/series以可下载行的形式提供单个公开 Compute Index 序列，单位为 USD / GPU-hour：已公布的定盘价（official_fixing，每个日期取最高修订版）和实时行情（indicative_tape），始终分别标注。空值保持为空，绝不填零。未作为 Reference 发布的序列会在 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"/indices/{slug}/fixings单个序列已公布的定盘价，按时间由新到旧排列。每个修订版都会列出，使更正与其所更正的值并列可见；is_latest_revision 标记每个日期的当前版本。可选择包含每个定盘价背后的服务商成分。没有已公布定盘价的序列返回空列表，绝不返回计算出的替代值。
| 参数 | 含义 |
|---|---|
| slug | 必填的序列 slug，即序列页面上 /index/ 之后的部分。 |
| limit | 1–500，默认 60。 |
| format | json（默认）或 csv（每个定盘修订版一行）。 |
| include | constituents（仅 json）：每个定盘价背后的各服务商数值和观测 ID。 |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"/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" />使用数据
null。Kovara 绝不用估算填补空白。comparable_usd_per_gpu_hour 是 Kovara 单独进行的标准化换算，其值为 null 时表示不存在可靠的换算。error 消息，HTTP 状态码为 400、404 或 503。