@kovara/sdk is a small, dependency-free client for the Kovara API, for Node.js 18 and later, Deno, Bun and browsers. The source and tests are in packages/kovara-sdk-js/.
import { Kovara, totalCost } from "@kovara/sdk";
const kovara = new Kovara({ apiKey: process.env.KOVARA_API_KEY });
const cheapest = await kovara.market.cheapest("nvidia-h100-sxm", 5); // no key needed
const report = await kovara.costs.report({ from: "2026-11-01" }); // launches:read
console.log(totalCost(report.rows, r => r.labels.team));| Area | Methods | Key |
|---|---|---|
market | offerings() (async iterator over every page), offeringsPage(), cheapest(), gpuPrices(), priceHistory(), indices(), indexSeries(), indexFixings(), changes(), brief() | none |
launches | connections(), list(), get(), request(), waitForLiveCheck(), confirm(), stop(), setLabels() | developer (kvk_) |
plans | list(), get(), request(), confirm(), cancel() | developer |
costs | report(), focusCsv(), csv() | developer |
org | whoami(), auditLog(), auditEvents() (follows truncated pages), costs(), focusCsv(), launches() | service account (kvo_) |
Behaviour:
- Keys are sent only to the configured base URL. Redirects are never followed, and only HTTPS is allowed (except for localhost).
- GET requests, and POSTs that carry an idempotency key, are retried on 429, 502, 503, 504 and network errors, with exponential backoff that honours
Retry-After. A launch request always carries an idempotency key, so a retry never launches twice. A confirm is never retried. KovaraErrorcarries the HTTP status and the API's own message.KovaraNetworkErrormeans the API could not be reached.
Build and test: cd packages/kovara-sdk-js && npm install && npm test.