GPU models, families, regions and reference prices — the vocabulary the catalog filters speak.
Four small endpoints supply the values that /offers filters expect. All require
catalog:read, none are paginated — each returns a bounded set in full — and all
change on the order of days.
Fetch these once at startup and cache them. Re-reading /regions on every user
keystroke is the easiest way to spend a rate limit on data that has not changed
since Tuesday.
This one endpoint answers “is there H100 capacity right now, and from what
price” — which is why there is no separate availability resource. It is the
right call for a landing page, a capacity dashboard, or the first screen of a
picker.
The cheapest live offer — or, when nothing is live, the reference price, so
the figure stays meaningful when the family is sold out. Read it together with
available if that distinction matters to you.
Use /offers?available=true when you need the individual offers rather than the
summary.
Every model that appears in the catalog. A model is a specific SKU; a family
groups the variants of a card. The example above is the distinction in one place:
two models, one family, different interconnects.Filter by gpu_model when the form factor genuinely matters — NVLink bandwidth
between SXM boards, say. Filter by gpu_family otherwise.
Curated reference pricing, independent of live inventory. It exists to answer
“what does an H100 cost” when nothing is listed at that moment — for a pricing
page, a budget estimate, or a cost model for capacity you plan to need next month.
A reference price is not an offer and cannot be rented. Never quote one to a user
as the price they will pay: use /offers for what is actually
rentable, and /rental-quotes for what a specific
rental will cost.
updated_at tells you how fresh the figure is. If it is weeks old and the family
has live offers, prefer the live price.
/gpu-families → "is there H100 capacity, from what price" → pick a family/offers → the individual rentable offers → pick an offer/rental-quotes → what THIS rental costs at THIS size → show the user/rentals → start it
/gpu-models and /regions supply the vocabulary for the filters at step two;
/prices covers the case where step one comes back empty.
