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)는 항상 별도로 표시됩니다. 빈 값은 빈 값 그대로 유지되며 영으로 바뀌지 않습니다. 게시된 공식 기준 지수가 아닌 시리즈는 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이 반환됩니다.