Marketplace

Browse spot compute by hardware profile and location.

Browse spot capacity on the marketplace by hardware profile and country

get

Requires pools:read (View grids and servers).

Authorizations

AuthorizationstringRequired

An API key from Account settings, e.g. kn_...

Query parameters

gpuTypesstring[] · max: 20Optional

GPU models to include, e.g. H100

noGpubooleanOptional

CPU-only machines

gpusPerMachineintegerOptional

Exact GPU count per machine

minCpusintegerOptional

Minimum physical CPU packages

minRamGbintegerOptional

Minimum RAM in GB

minStorageGbintegerOptional

Minimum disk in GB

locationstring · min: 1Optional

Marketplace location key

vettedOnlybooleanOptional

Only machines from vetted providers

tierIdsstring[] · max: 20Optional

Provider tiers to include

minGuaranteedDaysintegerOptional

Minimum availability guarantee

minNoticeHoursintegerOptional

Minimum notice before a machine is withdrawn

Responses

200

OK

application/json

400

The request body, query or headers are invalid (invalid_request, invalid_idempotency_key, ...)

application/json

401

The API key is missing, malformed, unknown, revoked or expired

application/json

403

The key lacks a required permission (insufficient_scope), is limited to other projects or to projects while the call acts on the organization (key_project_restricted), the caller's role on the resource is too low (forbidden), or the account is frozen

application/json

404

No such resource, or the caller cannot see it

application/json

429

Too many requests; see the X-RateLimit-* headers and Retry-After

application/json

500

Something failed on our side; the request id is in the body

application/json

502

A service we depend on (the runtime, GitHub) did not answer; retry shortly

application/json

503

The feature is not enabled on this server (github_not_configured), or a service we depend on is down; retry later

application/json

504

A service we depend on did not answer in time; retry shortly

application/json

get/marketplace

GET /v1/marketplace HTTP/1.1
Host: api.kinesis.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "listings": [
    {
      "configId": "text",
      "hardwareProfile": "text",
      "gpuModel": null,
      "gpusPerMachine": 1,
      "vramGbPerGpu": 1,
      "cpuThreads": 1,
      "minCpuPackages": 1,
      "ramGb": 1,
      "storageGb": 1,
      "countryCode": "text",
      "locationLabel": "text",
      "tierIds": [
        "text"
      ],
      "isVetted": true,
      "totalMachines": 1,
      "availableMachines": 1,
      "minPriceCentsPerHour": 1,
      "maxPriceCentsPerHour": 1,
      "pricePerGpuHourCents": 1,
      "guaranteedDays": 1,
      "isOpenEnded": true,
      "noticeHours": 1
    }
  ],
  "summary": {
    "availableMachines": 1,
    "configurations": 1,
    "fromPriceCentsPerGpuHour": 1,
    "fromPriceCentsPerHour": 1
  },
  "truncated": true
}