Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

name
string
required

Query Parameters

window
enum<string>
default:7d

Lookback window for the series.

Available options:
24h,
7d,
30d

Response

Successful Response

Bucketed availability time series for one accelerator over a window, served exclusively from hourly rollups. Estimates are honest or absent — never extrapolated past observed polls.

buckets
AcceleratorAvailabilityBucket · object[]
required

Hourly buckets covering polled hours of the window, oldest first. Empty when no observation in the window carried this accelerator anywhere: an honest no-data answer, never a series of fabricated zeros.

class
enum<string>
required
Available options:
gpu,
cpu
hour_of_day
AcceleratorHourOfDaySlot · object[]
required

24-slot UTC hour-of-day profile merged across the window. Empty when buckets is empty.

name
string
required
window
enum<string>
required
Available options:
24h,
7d,
30d
by_provider
AcceleratorProviderAvailability · object[]

Present only when the cluster does not anonymize providers; with anonymity on, only the cross-provider aggregate ships.