Loading
英語からの翻訳です。相違がある場合は英語版が優先されます。
公開データAPI
サイトに表示しているのと同じ公開レコードを提供する、無料の読み取り専用JSON APIです。キーは不要です。
エンドポイント
ベースURL https://www.kovaragrid.com/api/public/v1。レスポンスはJSON形式で、最大10分間キャッシュされます。すべてのレスポンスには meta ブロックが含まれ、生成日時、帰属表示、利用条件が記載されています。
/offerings現在の公開オファリングを、プロバイダー、GPU、リージョン、契約条件、元の掲載価格と単位、Kovaraが別途算出したGPU-hourあたりの比較可能なUSD価格、信頼度グレード、チェック日とともに返します。offering_idでページ分割されます。
| パラメーター | 意味 |
|---|---|
| gpu | 任意のGPUスラッグ。例：nvidia-h100-sxm（/gpusを参照）。 |
| provider | 任意のプロバイダースラッグ（/providersを参照）。 |
| limit | 1–500、デフォルトは100。 |
| cursor | 前のページのnext_cursorの値。 |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
/gpu-prices現在公開オファリングがあるすべてのGPUについて、オファリング数とプロバイダー数、GPU-hourあたりの比較可能なUSD価格の最小値、25パーセンタイル、中央値、75パーセンタイル、最大値を返します。オンデマンドは、全契約とは別に集計されます。
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
/price-history一つのオファリングについて公表された価格の観測値を、新しい順に返します。元の値と単位を、正規化されたGPU-hourあたりのUSD価格、観測の種類、信頼度グレードと並べて示します。出典は各オファリングのページに記載されています。
| パラメーター | 意味 |
|---|---|
| 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の一つのシリーズを、GPU-hourあたりのUSD建てでダウンロード可能な行として返します。公表済みのフィキシング（official_fixing、日付ごとの最新改訂）とライブテープ（indicative_tape）は、常に区別して表示されます。空の値は空のままで、ゼロにはなりません。公表済みのReferenceではないシリーズは、meta.publication_stateでその旨が示されます。
| パラメーター | 意味 |
|---|---|
| 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 | 必須のシリーズスラッグ。シリーズページの/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.svgCompute Indexシリーズの最新の公表フィキシングを表示する、帰属表示付きの埋め込み用SVGカードです。記事、資料、プロバイダーページでご利用いただけます。候補値をリファレンスとして表示することはありません。
| パラメーター | 意味 |
|---|---|
| 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のいずれかとともに返されます。