# Offers and availability API
Use this endpoint for new catalogue integrations. A single request returns SwissGPU’s dedicated GPU models, server specs, commercial availability, on-demand rates and prepaid offers in CHF and indicative USD. No account or API key is required.

## Read offers

```
curl https://www.swissgpu.ch/api/v1/offers
```

[Open the JSON response](https://www.swissgpu.ch/api/v1/offers) · [OpenAPI schema](https://www.swissgpu.ch/api/v1/openapi.json) · [Markdown guide](https://www.swissgpu.ch/docs/offers-api.md) · [Resource index](https://www.swissgpu.ch/llms.txt)

## What it returns

- `currency`: `CHF`. `unit`: `hour`. `observed_at`: UTC response time. Fetch again for current prices.

- `offers`: one entry per catalogue model, with its `gpu` identifier and display `name`. Use `gpu` as the stable key when matching models across reads.

- `hourly_price` is the on-demand compute rate in CHF/hour. `hourly_price_usd` is its indicative USD/hour equivalent. Existing rentals keep their agreed rates.

- `specifications`: `vram_gb`, `cpu_cores`, `ram_gb`, `storage` and `architecture`. These are strings and may describe ranges.

- `prepaid_terms`: enabled terms with `months`, `discount_percent`, `hourly_cents` and upfront `compute_cents` in integer CHF cents. `hourly_usd` and `compute_usd` are the indicative hourly and upfront amounts in US dollars. An empty list means no enabled terms.

- `availability`: every listed model reports `available` as a commercial offer. For current rentable capacity, use authenticated `GET /api/v1/capacity`. A rental request confirms allocation.

- `model_url`: GPU information. `rental_url`: website rental flow. `specifications_url`: NVIDIA specifications.

- `fees`: additional charges and service terms. `billing_details_url`: full [pricing and billing details](https://www.swissgpu.ch/docs/pricing).

## USD estimates
All USD amounts use the same reference rate and are rounded to four decimal places. Billing is in CHF. In `usd_exchange_rate`, `rate` is USD per CHF, `date` is the reference date, and `source` is `ECB`. The API attempts to refresh the daily reference rate at most once an hour. If a refresh fails, it keeps the last available rate with `stale` set to `true`. If no rate is available, the metadata and USD amounts are `null`. CHF amounts are still returned.

## Prepaid terms
Compare enabled 1, 2, 3, 6 or 12-month prepaid terms for a lower hourly compute rate where offered. Each month is 30 days. Review discounts and upfront totals on the [pricing page](https://www.swissgpu.ch/docs/pricing) and start a prepaid booking there. The customer rental API creates on-demand rentals.

## Rent a server
Use a model’s rental link to book on the website, or follow the [customer API walkthrough](https://www.swissgpu.ch/docs/customer-api) to create a token, check capacity and images, rent, poll setup and retrieve SSH details. This public endpoint only reads offers; it does not reserve servers or accept payments.
Browse the [GPU catalogue](https://www.swissgpu.ch/docs/gpus) and [setup guides](https://www.swissgpu.ch/docs) for workload selection. See [network specifications](https://www.swissgpu.ch/docs/network) for IPv6 and optional shared IPv4 connectivity.

## Limits and errors
Poll at most once per minute. Public pricing and offers allow an average of 60 requests/minute per IP, with bursts of 10. On HTTP 429 or 503, respect `Retry-After` before retrying. An unavailable or incomplete catalogue returns 503 instead of stale or partial prices.
Existing integrations can continue using the [Legacy Pricing API](https://www.swissgpu.ch/docs/pricing-api). To reproduce its hourly prices from offers, select the term with `months` equal to `12` and use `hourly_cents` divided by 100 or `hourly_usd`. If the 12-month term is absent, use `hourly_price` or `hourly_price_usd`.