Every Kovara endpoint, by the key it takes. Base URL: https://www.kovaragrid.com.
Public market data (no key)
Read-only, CORS-enabled, and attributed in every response's meta. The original listed price is always kept next to Kovara's comparable USD per GPU-hour value. Neither is a quote.
| Endpoint | Returns |
|---|---|
GET /api/public/v1/offerings?gpu=&provider=&limit=1..500&cursor= | Current public offerings, keyset-paginated (next_cursor) |
GET /api/public/v1/gpu-prices | Price distribution per GPU across current offerings |
GET /api/public/v1/price-history?offering=&days=1..365 | Published price observations of one offering |
GET /api/public/v1/skypilot (?gpu=&gpus=&spot=&clouds=&fallbacks=&format=json|yaml) | SkyPilot task files ranked by capacity reported in the last 15 minutes, then listed price (guide) |
GET /api/public/v1/indices | Compute Index definitions |
GET /api/public/v1/indices/{slug}/series?range=24H|7D|30D|All&format=json|csv | An index series |
GET /api/public/v1/indices/{slug}/fixings?limit=&format=&include=constituents | Index fixings |
GET /api/public/v1/market/changes, /market/changes/rss, /market/brief | Recent market changes and the written brief |
POST /api/mcp | The same data as an MCP server (tools gpu_prices, search_offerings, price_history, compute_indices, market_brief) |
Your launches and costs (developer key, kvk_…)
Create a key at Account → Developer with the scopes you need. The full OpenAPI 3.1 description is at /api/v1/openapi.json.
| Endpoint | Scope |
|---|---|
GET /api/v1/connections | launches:read |
GET /api/v1/launches, GET /api/v1/launches/{id} | launches:read |
POST /api/v1/launches, POST /api/v1/launches/{id}/confirm, POST /api/v1/launches/{id}/stop | launches:write |
PUT /api/v1/launches/{id}/labels | launches:write |
GET /api/v1/launch-plans, GET /api/v1/launch-plans/{id} | launches:read |
POST /api/v1/launch-plans, …/{id}/confirm, …/{id}/cancel | launches:write |
GET /api/v1/costs?from=&to=&organization_id=&format=json|csv|focus | launches:read |
Organizations (service account key, kvo_…, read only)
| Endpoint | Scope |
|---|---|
GET /api/v1/org/whoami | any |
GET /api/v1/org/audit-log?since=&until=&format=json|jsonl|csv | audit:read |
GET /api/v1/org/costs?from=&to=&format=json|csv|focus | costs:read |
GET /api/v1/org/launches | launches:read |
Webhooks
Kovara signs every webhook delivery with Kovara-Signature: t=…,v1=… (HMAC-SHA256). See notification channels.
Clients
Errors
Every error is JSON, {"error": "…"}:
| Status | Meaning |
|---|---|
401 | Missing, invalid, revoked or expired key |
403 | The key lacks the scope |
404 | Not found, or the feature is switched off |
409 | Not possible in the current state |
413 | Too many rows in the window |
422 | Invalid input or refused by a rule |
429 | Rate limit |
503 | Temporarily unavailable |
Nothing is ever guessed to fill a gap.