> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-eng-de/fur-hosts/api.md).

# API

> 💡 **Python-Entwickler:** Verwenden Sie das offizielle [clore-ai Python SDK](https://docs.clore.ai/clore.ai/clore.ai-eng-de/entwickler/python-sdk.md) anstelle direkter API-Aufrufe. Es übernimmt Authentifizierung, Ratenbegrenzung, Wiederholungen und Fehlerbehandlung automatisch.
>
> **Schnellstart:** `pip install clore-ai` — Siehe die [Dokumentation des Python-SDK](https://docs.clore.ai/clore.ai/clore.ai-eng-de/entwickler/python-sdk.md) und [CLI-Referenz](https://docs.clore.ai/clore.ai/clore.ai-eng-de/entwickler/cli-guide.md).

> 🧭 Bevorzugen Sie eine durchsuchbare Referenz? Öffnen Sie die interaktive API-Dokumentation unter [clore.ai/api-docs](https://clore.ai/api-docs). Basis-URL für alle Endpunkte auf dieser Seite: `https://api.clore.ai/v1/`.

<div data-full-width="true"><figure><img src="https://3465007990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyNlC5NV8aIpXnc76G7w%2Fuploads%2FoEhopGeayaKnbuDjgTEs%2FCLORE%20Docs%20API%20Page.png?alt=media&amp;token=a0adf6bb-1fde-4f1b-8236-dff2563ffbfd" alt=""><figcaption></figcaption></figure></div>

### Einführung <a href="#introduction" id="introduction"></a>

[CLORE.AI](http://clore.ai/) api kann verwendet werden, um Bereitstellungen Ihrer Workloads auf [CLORE.AI](http://clore.ai/)

Zunächst müssen Sie einen API-Schlüssel erhalten\
![alt text](https://clore.ai/assets/html/api-export1.png)\
![alt text](https://clore.ai/assets/html/api-export2.png)

***

### API-Antworten <a href="#api-responses" id="api-responses"></a>

Antworten werden im JSON-Format zurückgegeben und können unterschiedliche Felder haben

Das immer zurückgegebene Feld ist code und zeigt den Status an

**code-Feld**

| code | Beschreibung                               |
| ---- | ------------------------------------------ |
| `0`  | NORMAL                                     |
| `1`  | DATENBANKFEHLER                            |
| `2`  | UNGÜLTIGE EINGABEDATEN                     |
| `3`  | UNGÜLTIGES API-TOKEN                       |
| `4`  | UNGÜLTIGER ENDPOINT                        |
| `5`  | Grenze von 1 Anfrage/Sekunde überschritten |
| `6`  | Fehler angegeben in `Fehler` Feld          |

***

### Endpunkte <a href="#endpoints" id="endpoints"></a>

#### 1. `wallets` <a href="#id-1-wallets" id="id-1-wallets"></a>

**Info**

Gibt Wallets und Guthaben zurück

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Ausgabe**

| Feld      | Typ        | Beschreibung      |
| --------- | ---------- | ----------------- |
| `code`    | `int`      | Statuscode        |
| `wallets` | `[]string` | Array von Wallets |

**Beispiel**

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/wallets'
```

**Ausgabe:**

```
{
  "wallets": [
    {
      "name": "bitcoin",
      "deposit": "tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr",
      "balance": 0.00153176,
      "withdrawal_fee": 0.0001
    }
  ],
  "code": 0
}
```

#### 2. `my_servers` <a href="#id-2-my_servers" id="id-2-my_servers"></a>

**Info**

Gibt Ihre Server zurück, die Sie an [clore.ai](http://clore.ai/) Marktplatz

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Ausgabe**

| Feld                                  | Typ            | Beschreibung                                                                                                                                                                                                                                                                                                   |
| ------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                                | `int`          | Statuscode                                                                                                                                                                                                                                                                                                     |
| `Limit`                               | `int`          | Maximale Anzahl an Servern, die Sie besitzen können                                                                                                                                                                                                                                                            |
| `Server`                              | `[]string`     | Array von Servern                                                                                                                                                                                                                                                                                              |
| `servers[x].name`                     | `Zeichenkette` | Vom Benutzer gewählter Servername                                                                                                                                                                                                                                                                              |
| `servers[x].connected`                | `Zeichenkette` | War der Server jemals verbunden mit [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                               |
| `servers[x].visibility`               | `Zeichenkette` | Sichtbarkeit auf dem Marktplatz                                                                                                                                                                                                                                                                                |
| `servers[x].pricing`                  | `[]string`     | Preis/Tag bei On-Demand                                                                                                                                                                                                                                                                                        |
| `servers[x].online`                   | `bool`         | Ist der Server online                                                                                                                                                                                                                                                                                          |
| `servers[x].min_spot_pricing`         | `[]string`     | Mindestpreis/Tag für die Vermietung auf dem Spot-Markt                                                                                                                                                                                                                                                         |
| `servers[x].auto_renew_allowed`       | `bool`         | Ob On-Demand-Bestellungen von Mietern auf diesem Server zu Ihrem aktuellen Preis verlängert werden dürfen, wenn sie die maximale Mietdauer erreichen. `true` wenn Sie es nie festgelegt haben. Fehlt bei einem Server, der entfernt wird. Ändern Sie es mit [`set_server_settings`](#id-7-set_server_settings) |
| `servers[x].init_token`               | `Zeichenkette` | Maschinenregistrierungs-Token, wird nur bis zur Initialisierung der Maschine zurückgegeben — **als Zugangsdaten behandeln**, es registriert Maschinen in Ihrem Konto                                                                                                                                           |
| `servers[x].specs`                    | `[]string`     | Serverspezifikationen                                                                                                                                                                                                                                                                                          |
| `servers[x].remaining_time`           | `int`          | Endzeit der Miete der zuletzt aktiven Bestellung (ms seit Epoch)                                                                                                                                                                                                                                               |
| `servers[x].rental_state`             | `Zeichenkette` | Aggregierter GPU-Mietstatus: `none`, `partial`, oder `full`                                                                                                                                                                                                                                                    |
| `servers[x].rented_gpus`              | `int`          | Derzeit über aktive Bestellungen vermietete GPUs                                                                                                                                                                                                                                                               |
| `servers[x].total_gpus`               | `int`          | Gesamte GPUs auf dem Server                                                                                                                                                                                                                                                                                    |
| `servers[x].rented_price_by_currency` | `Objekt`       | Summe der Preise aktiver Bestellungen, nach Währung                                                                                                                                                                                                                                                            |
| `servers[x].update_channel`           | `Zeichenkette` | Update-Kanal des Hosting-Agenten: `stable` oder `beta`                                                                                                                                                                                                                                                         |
| `servers[x].requested_channel`        | `Zeichenkette` | Vom Web-UI angeforderter Kanalwechsel (nur vorhanden, wenn angefordert)                                                                                                                                                                                                                                        |
| `servers[x].target_backend_version`   | `int`          | Backend-Version, auf die der aktuelle Kanal abzielt                                                                                                                                                                                                                                                            |

> Die Mietstatus-Felder (`remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`) sind nur vorhanden, solange der Server eine aktive Bestellung hat.

**Beispiel**

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_servers'
```

**Ausgabe:**

```
{
  "servers": [
    {
      "name": "Michael",
      "connected": false,
      "visibility": "hidden",
      "pricing": { "bitcoin": 0, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0, "usd": 0 },
      "auto_renew_allowed": true,
      "init_token": "qnwVIMsZPjUWS7jw6gAbTOeoGQNgTH9XVxJaiCEbG0OlmfjF"
    },
    {
      "name": "Jan Vykydal",
      "connected": true,
      "visibility": "public",
      "pricing": { "bitcoin": 0.00010337, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "Intel Core i9-11900",
        "cpus": "8/16",
        "ram": 64,
        "disk": "NVMe 512GB",
        "disk_speed": 2000,
        "gpu": "1x GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "down":119.61,
          "up":25.24
        }
      }
    }
  ],
  "limit": 16,
  "code": 0
}
```

USD-Werte in `pricing` Objekten spiegeln den USD-basierten Preisgestaltungsmodus wider, den der Host aktiviert hat.

#### 3. `server_config` <a href="#id-3-server_config" id="id-3-server_config"></a>

**Info**

Konfiguration eines bestimmten Servers abrufen

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld          | Typ            | Pflichtangabe | Beschreibung |
| ------------- | -------------- | ------------- | ------------ |
| `server_name` | `Zeichenkette` | Ja            | Servername   |

**Ausgabe**

| Feld                        | Typ                        | Beschreibung                                                                                                                                                       |
| --------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                      | `int`                      | Statuscode                                                                                                                                                         |
| `creation_completed`        | `bool`                     | Ist die Servererstellung abgeschlossen                                                                                                                             |
| `config`                    | `[]string`                 | Serverkonfiguration                                                                                                                                                |
| `config.name`               | `Zeichenkette`             | Vom Benutzer gewählter Servername                                                                                                                                  |
| `config.connected`          | `bool`                     | War der Server jemals verbunden mit [clore.ai](http://clore.ai/)                                                                                                   |
| `config.visibility`         | `Zeichenkette`             | Sichtbarkeit auf dem Marktplatz                                                                                                                                    |
| `config.pricing`            | `[]string`                 | Preis/Tag bei On-Demand                                                                                                                                            |
| `config.spot_pricing`       | `[]string`                 | Mindestpreis/Tag für die Vermietung auf dem Spot-Markt                                                                                                             |
| `config.mrl`                | `int`                      | Maximale Mietdauer in Stunden                                                                                                                                      |
| `config.auto_renew_allowed` | `bool`                     | Ob On-Demand-Bestellungen von Mietern auf diesem Server zu Ihrem aktuellen Preis verlängert werden dürfen, wenn sie `mrl`. `true` wenn Sie es nie festgelegt haben |
| `config.online`             | `bool`                     | Ist der Server online                                                                                                                                              |
| `config.initialized`        | `bool`                     | War der Server jemals verbunden mit [clore.ai](http://clore.ai/)                                                                                                   |
| `config.id`                 | `int`                      | Eindeutige Server-ID                                                                                                                                               |
| `config.rental_status`      | `int`                      | 0 - nicht vermietet \| 1 - auf dem Spot-Markt vermietet \| 2 - On-Demand vermietet \| 3 - USD-Festpreisvermietung                                                  |
| `config.specs`              | `[]string`                 | Serverspezifikationen                                                                                                                                              |
| `config.background_job`     | `Objekt`                   | Hintergrundjob, wenn nicht vermietet: `Image`, `command`, `env`, `times_updated`                                                                                   |
| `config.autoprice`          | `Objekt` \| `Zeichenkette` | Konfiguration der automatischen Preisgestaltung pro Währung (veraltete Zeichenkettenwerte `"pow"` / `"usd"` kommen ebenfalls vor)                                  |
| `config.usd_pricing`        | `Objekt`                   | USD-Preisziele — nur vorhanden, wenn die automatische USD-Preisgestaltung aktiviert ist                                                                            |
| `config.tenants`            | `[]Objekt`                 | Aktive Bestellungen auf dem Server: `rental_type`, `Währung`, `price`, `remaining_time`, `gpu_count`                                                               |

> `server_config` gibt außerdem dieselben Mietstatus- und Update-Kanal-Felder zurück wie `my_servers`: `remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`, `update_channel`, `requested_channel`, `target_backend_version`. In beiden Endpunkten sind die Mietstatus-Felder nur vorhanden, solange der Server eine aktive Bestellung hat.

**Beispiel**

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "server_name":"Jan Vykydal"
}' 'https://api.clore.ai/v1/server_config'
```

**Ausgabe:**

```
{
  "config": {
    "name": "Jan Vykydal",
    "connected": true,
    "visibility": "public",
    "pricing": { "bitcoin": 0.00010337, "usd": 0 },
    "spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
    "mrl": 72,
    "auto_renew_allowed": true,
    "online": false,
    "initialized": true,
    "id": 4,
    "rental_status": 0,
    "specs": {
      "mb": "Z590 GAMING X",
      "cpu": "Intel Core i9-11900",
      "cpus": "8/16",
      "ram": 64,
      "disk": "NVMe 512GB",
      "disk_speed": 2000,
      "gpu": "1x GeForce GTX 1080 Ti",
      "gpuram": 11,
      "net": {
        "down":119.61,
        "up":25.24
      }
    },
    "background_job": {
      "times_updated": 1,
      "image": "cloreai/ubuntu20.04-jupyter",
      "command": "",
      "env": []
    }
  },
  "creation_completed": true,
  "code": 0
}
```

USD-Werte in `pricing` Objekten spiegeln den USD-basierten Preisgestaltungsmodus wider, den der Host aktiviert hat.

#### 4. `Marktplatz` <a href="#id-4-marketplace" id="id-4-marketplace"></a>

**Info**

Marktplatz abrufen

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Ausgabe**

| Feld                            | Typ                | Beschreibung                                                                                                                                                                                                                                                        |
| ------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                          | `int`              | Statuscode                                                                                                                                                                                                                                                          |
| `my_servers`                    | `[]string`         | Array von Server-IDs, die Sie an [clore.ai](http://clore.ai/) (kann nicht gemietet werden)                                                                                                                                                                          |
| `Server`                        | `[]string`         | Array öffentlicher Server auf dem Marktplatz                                                                                                                                                                                                                        |
| `servers[x].id`                 | `int`              | Eindeutige Server-ID                                                                                                                                                                                                                                                |
| `servers[x].owner`              | `int`              | Eindeutige Besitzer-ID                                                                                                                                                                                                                                              |
| `servers[x].mrl`                | `int`              | Maximale Mietdauer in Stunden. Wenn der Server automatische Verlängerung erlaubt, ist dies auch der Neupreiszeitraum: Eine sich verlängernde Bestellung übernimmt bei jedem Erreichen dieser Dauer den aktuellen Preis des Hosts                                    |
| `servers[x].auto_renew_allowed` | `bool`             | Ob der Host die automatische Verlängerung auf diesem Server erlaubt. `true` wenn der Host es nie festgelegt hat. Wenn `false`, `create_order` mit `auto_renew: true` wird abgelehnt mit `auto_renew_not_allowed`, und `rental_hours` kann nicht überschreiten `mrl` |
| `servers[x].price.on_demand`    | `[]string`         | On-Demand-Preis pro Tag                                                                                                                                                                                                                                             |
| `servers[x].price.spot`         | `[]string`         | Mindestpreis pro Tag auf dem Spot-Markt                                                                                                                                                                                                                             |
| `servers[x].rented`             | `bool`             | Ist der Server auf On-Demand-Basis vermietet                                                                                                                                                                                                                        |
| `servers[x].specs`              | `[]string`         | Serverspezifikationen                                                                                                                                                                                                                                               |
| `servers[x].partial_gpu_rental` | `Objekt` \| `bool` | `false` wenn Teilvermietung nicht verfügbar ist, andernfalls `{ total_gpus, available_gpus, free_indices }`                                                                                                                                                         |

> `price.on_demand` und `price.spot` beziehen Sie nur die Währungen ein, die jeder Server tatsächlich akzeptiert — ein Server ohne Preis in einer bestimmten Währung kann darin nicht gemietet werden.
>
> Die Auflistung ist ein zwischengespeicherter Schnappschuss, daher kann es einige Minuten dauern, bis eine Änderung an einem Server `mrl` oder `auto_renew_allowed` hier sichtbar wird.

**Beispiel**

Marktplatz abrufen

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/marketplace'
```

**Ausgabe:**

```
{
  "servers": [
    {
      "id": 6,
      "owner": 4,
      "mrl": 73,
      "price": { "on_demand": { "bitcoin": 0.00001 },
      "spot": { "bitcoin": 0.000001 }},
      "rented": false,
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 0,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
          "cc": "CZ"
        }
      }
    }
  ],
  "my_servers": [1, 2, 4],
  "code": 0
}
```

#### 5. `my_orders` <a href="#id-5-my_orders" id="id-5-my_orders"></a>

**Info**

Rufen Sie Ihre Bestellungen ab

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Query-String**

| Feld               | Typ    | Pflichtangabe | Beschreibung                                          |
| ------------------ | ------ | ------------- | ----------------------------------------------------- |
| `return_completed` | `bool` | Nein          | Abgeschlossene (abgelaufene) Bestellungen zurückgeben |

**Ausgabe**

| Feld                             | Typ            | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                           | `int`          | Statuscode                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `Limit`                          | `int`          | Derzeit immer 999999                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `Bestellungen`                   | `[]string`     | Array von Bestellungen                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].id`                   | `int`          | Eindeutige Bestell-ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].creation_fee`         | `float`        | Erstellungsgebühr gezahlt an [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `orders[x].price`                | `float`        | Bestellpreis (Kosten) pro Tag                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].mrl`                  | `int`          | Sekunden von der Erstellung bis zum Ende der aktuellen Laufzeit. Eine Verlängerung fügt die neue Laufzeit hinzu, also `ct + mrl` ist immer das aktuelle Ende                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].image`                | `Zeichenkette` | Verwendetes Docker-Image                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].currency`             | `Zeichenkette` | Für die Abrechnung verwendete Währung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].spend`                | `float`        | Bisher tatsächlich belasteter Betrag: aufgelaufener Mietwert plus die Basisgebühr des Mieters (nach PoH-Reduktion) und etwaige Zusatzgebühren; ohne die einmalige Erstellungsgebühr                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].gpu_count`            | `int`          | Anzahl der GPUs, die die Bestellung belegt (On-Demand-Bestellungen; entspricht den gesamten GPUs des Rigs, sofern es sich nicht um eine Teilvermietung handelt)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `orders[x].ct`                   | `int`          | Erstellungszeit (UNIX-Zeit)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].p`                    | `int`          | Derzeit verwendeter Proxy-Cluster                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `orders[x].specs`                | `[]string`     | Serverspezifikationen                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].si`                   | `int`          | Eindeutige Server-ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].pub_cluster`          | `[]string`     | Öffentliche Endpunkte mit weitergeleiteten Ports                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].tcp_ports`            | `[]string`     | TCP-Portweiterleitung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].http_port`            | `Zeichenkette` | Container-Port über HTTPS-Proxy weitergeleitet                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].spot`                 | `bool`         | Hinweis, dass es sich um eine Spot-Bestellung handelt                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].expired`              | `bool`         | Hinweis, dass die Bestellung abgelaufen ist                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].rental_hours`         | `int`          | Von Ihnen angeforderte Stunden, gezählt ab der Erstellung (nur On-Demand). Fehlt, wenn kein Limit angefordert wurde: Die Bestellung endet dann bei der maximalen Mietdauer des Hosts, sofern `auto_renew` aktiv ist, läuft sie, bis Sie sie kündigen                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].rental_end`           | `int`          | UNIX-Zeit, wenn die angeforderten Stunden aufgebraucht sind; fehlt, wenn kein Limit angefordert wurde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].term_start`           | `int`          | UNIX-Zeit, zu der die aktuelle Laufzeit begann (Erstellung oder letzte Verlängerung)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].term_end`             | `int`          | UNIX-Zeit, zu der die aktuelle Laufzeit endet; immer `ct + mrl`. Fehlt bei Spot-Bestellungen und bei einer On-Demand-Bestellung, die vor Einführung der automatischen Verlängerung erstellt und seitdem nie bearbeitet wurde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].term_mrl`             | `int`          | Die maximale Mietdauer des Hosts, in Sekunden, als die aktuelle Laufzeit begann. [`set_order_auto_renew`](#id-16-set_order_auto_renew) kann die aktuelle Laufzeit verlängern auf bis zu `term_start + term_mrl`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `orders[x].last_renewal_at`      | `int`          | UNIX-Zeit, zu der die letzte Verlängerung angewendet wurde; fehlt vor der ersten Verlängerung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].auto_renew`           | `bool`         | Ob die Bestellung am Ende der aktuellen Laufzeit zu den aktuellen Preisen des Hosts verlängert wird. Wird gesetzt auf `false` wenn eine Verlängerung abgelehnt wird. Fehlt bei einer Bestellung, die ohne automatische Verlängerung erstellt und nie bearbeitet wurde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].auto_renew_max_price` | `float`        | Ihr Preislimit pro Tag für Verlängerungen in der Währung der Bestellung. Eine Verlängerung wird abgelehnt, wenn der Preis des Hosts darüber liegt                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `orders[x].renewals_count`       | `int`          | Anzahl der bisher angewendeten Verlängerungen; fehlt vor der ersten Verlängerung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].pending_renewal`      | `Objekt`       | Vorhanden, solange eine Verlängerung für das Ende der aktuellen Laufzeit geplant ist: `price` (`float`, der Preis pro Tag der nächsten Laufzeit) und `term_seconds` (`int`, die Länge der nächsten Laufzeit in Sekunden)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].auto_renew_declined`  | `Objekt`       | Wird angezeigt, nachdem eine Verlängerung abgelehnt wurde: `Grund` und `bei` (UNIX-Zeit der Entscheidung). Die Bestellung endet mit ihrer aktuellen Laufzeit. `Grund` ist eines von `price_above_cap` (der neue Preis des Hosts pro Tag liegt über `auto_renew_max_price`), `server_unlisted` (der Server ist verborgen oder wird entfernt, akzeptiert die Währung der Bestellung nicht mehr oder hat dafür keinen Preis mehr, oder besteht die Gesundheitsprüfungen nicht mehr, die eine neue Bestellung bestehen muss), `host_disallowed` (der Host hat die automatische Verlängerung deaktiviert), `server_reserved` (der Server ist für einen anderen Mieter reserviert) oder `insufficient_balance` (nach Bezahlung der Zeit bis zum Ende der Laufzeit würde dein Guthaben zum neuen Preis weniger als eine Stunde abdecken) |

> Jede seit Einführung der automatischen Verlängerung erstellte On-Demand-Bestellung enthält `term_start`, `term_end` und `term_mrl`. Die anderen Verlängerungsfelder erscheinen nur, wenn sie zutreffen: `rental_hours` und `rental_end` wenn Stunden angefordert wurden, `auto_renew` und `auto_renew_max_price` wenn die automatische Verlängerung bei der Erstellung angefordert oder über [`set_order_auto_renew`](#id-16-set_order_auto_renew), und `renewals_count` und `last_renewal_at` nach der ersten Verlängerung. Siehe [Mietdauer und automatische Verlängerung](https://docs.clore.ai/clore.ai/clore.ai-eng-de/fur-mieter/order-management.md#rental-length-and-auto-renewal).

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_orders?return_completed=true'
```

Die erste Bestellung unten ist eine On-Demand-Bestellung auf einem Server mit einer maximalen Mietdauer von 73 Stunden (`mrl` von 262800 Sekunden), erstellt mit `rental_hours: 120` und aktivierter automatischer Verlängerung und befindet sich noch in ihrer ersten Laufzeit. Die zweite ist eine abgelaufene Spot-Bestellung.

**Ausgabe:**

```
{
  "orders": [
    {
      "id": 38,
      "creation_fee": 3e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 6.944444444444445e-9,
      "ct": 1667401396,
      "p": 1,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "pub_cluster": [ "n1.c1.clorecloud.net", "n2.c1.clorecloud.net" ],
      "tcp_ports": [ "22:10000" ],
      "http_port": "8888",
      "ssh_auth": "password",
      "rental_hours": 120,
      "rental_end": 1667833396,
      "term_start": 1667401396,
      "term_end": 1667664196,
      "term_mrl": 262800,
      "auto_renew_max_price": 0.0000125,
      "auto_renew": true
    },{
      "id": 36,
      "creation_fee": 1e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 1.3888888888888888e-7,
      "ct": 1667248597,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "spot": true,
      "ssh_auth": "password",
      "expired": true,
      "tcp_ports": []
    }
  ],
  "limit": 999999,
  "code": 0
}
```

#### 6. `spot_marketplace` <a href="#id-6-spot_marketplace" id="id-6-spot_marketplace"></a>

**Info**

Spot-Marktplatz für einen bestimmten Server abrufen

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Query-String**

| Feld     | Typ   | Pflichtangabe | Beschreibung         |
| -------- | ----- | ------------- | -------------------- |
| `market` | `int` | Ja            | Eindeutige Server-ID |

**Ausgabe**

| Feld                           | Typ            | Beschreibung                                                                             |
| ------------------------------ | -------------- | ---------------------------------------------------------------------------------------- |
| `code`                         | `int`          | Statuscode                                                                               |
| `exists`                       | `bool`         | Überprüfung, dass der Markt existiert                                                    |
| `market`                       | `Objekt`       | Marktplatz                                                                               |
| `market.offers`                | `array`        | Mietangebote für den Server                                                              |
| `market.offers[x].offer_id`    | `int`          | Eindeutige Angebots-ID                                                                   |
| `market.offers[x].bid`         | `float`        | Angebotener Preis pro Tag (in der Währung des Angebots)                                  |
| `market.offers[x].currency`    | `Zeichenkette` | Währung des Gebots                                                                       |
| `market.offers[x].active`      | `bool`         | Dieses Angebot wird derzeit verwendet                                                    |
| `market.offers[x].my`          | `bool`         | Dieses Angebot gehört mir                                                                |
| `market.server`                | `Objekt`       | Serverinformationen                                                                      |
| `market.server.min_pricing`    | `Objekt`       | Minimaler Angebotspreis pro Tag, je akzeptierter Währung                                 |
| `market.server.mrl`            | `int`          | Maximale Mietdauer in **Stunden**                                                        |
| `market.server.visibility`     | `Zeichenkette` | Du kannst Angebote nur erstellen, wenn die Sichtbarkeit öffentlich ist                   |
| `market.server.online`         | `bool`         | Server ist online                                                                        |
| `market.currency_rates_in_usd` | `Objekt`       | Aktuelle USD-Kurse, die verwendet werden, um Gebote über Währungen hinweg zu vergleichen |

> Angebote können in jeder vom Server akzeptierten Währung abgegeben werden; konkurrierende Gebote werden anhand ihres **USD-Werts** (unter Verwendung von `currency_rates_in_usd`), nicht des Nennwerts.
>
> ⚠️ **Geändert im August 2026:** `market.server.mrl` wird jetzt zurückgegeben in **Stunden** (früher Sekunden). Ein Wert, der früher lautete `262800` lautet jetzt `73`.

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/spot_marketplace?market=6'
```

**Ausgabe:**

```
{
  "market": {
    "offers": [
      {
        "offer_id": 39,
        "bid": 0.0000042,
        "active": true,
        "my": true,
        "currency": "bitcoin"
      }
    ],
    "server": {
      "min_pricing": {
        "bitcoin": 0.000001
      },
      "mrl": 73,
      "visibility": "public",
      "online": true
    },
    "currency_rates_in_usd": {
      "bitcoin": 110000,
      "CLORE-Blockchain": 0.0045,
      "USD-Blockchain": 1
    }
  },
  "exists": true,
  "code": 0
}
```

#### 7. `set_server_settings` <a href="#id-7-set_server_settings" id="id-7-set_server_settings"></a>

**Info**

Konfiguriere die Einstellungen des Servers, den du bereitstellst auf [clore.ai](http://clore.ai/) Marktplatz

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld                         | Typ            | Pflichtangabe | Beschreibung                                                                                                                                                                                                                                                                                                                  |
| ---------------------------- | -------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                       | `Zeichenkette` | Ja            | Vom Benutzer gewählter Servername                                                                                                                                                                                                                                                                                             |
| `Verfügbarkeit`              | `bool`         | Ja            | Kann der Server gemietet werden                                                                                                                                                                                                                                                                                               |
| `mrl`                        | `int`          | Ja            | Maximale Mietdauer des Servers in **Stunden** (6 bis 3000)                                                                                                                                                                                                                                                                    |
| `bitcoin_on_demand`          | `float`        | Ja            | On-Demand-Preis in BTC pro Tag                                                                                                                                                                                                                                                                                                |
| `bitcoin_spot`               | `float`        | Ja            | Minimaler Spotpreis in BTC pro Tag                                                                                                                                                                                                                                                                                            |
| `CLORE-Blockchain_on_demand` | `float`        | Nein          | On-Demand-Preis in CLORE pro Tag                                                                                                                                                                                                                                                                                              |
| `CLORE-Blockchain_spot`      | `float`        | Nein          | Minimaler Spotpreis in CLORE pro Tag                                                                                                                                                                                                                                                                                          |
| `USD-Blockchain_on_demand`   | `float`        | Nein          | On-Demand-Preis in USD pro Tag                                                                                                                                                                                                                                                                                                |
| `USD-Blockchain_spot`        | `float`        | Nein          | Minimaler Spotpreis in USD pro Tag                                                                                                                                                                                                                                                                                            |
| `enabled-bitcoin`            | `bool`         | Nein\*        | Bitcoin für diesen Server akzeptieren                                                                                                                                                                                                                                                                                         |
| `enabled-CLORE-Blockchain`   | `bool`         | Nein\*        | CLORE für diesen Server akzeptieren                                                                                                                                                                                                                                                                                           |
| `enabled-USD-Blockchain`     | `bool`         | Nein\*        | USD-Stablecoins für diesen Server akzeptieren                                                                                                                                                                                                                                                                                 |
| `autoprice`                  | `Objekt`       | Nein          | Automatische Preisfestlegung pro Währung: Setze einen Währungsschlüssel (`bitcoin`, `CLORE-Blockchain`) auf `"usd"` für USD-basierte automatische Preisfestlegung oder `false` für feste Preisgestaltung                                                                                                                      |
| `usd_pricing`                | `Objekt`       | Nein          | USD-Preisziele pro Währung, z. B. `{ "bitcoin": { "on_demand": 10, "spot": 5 } }` — wird nur für Währungen verwendet, bei denen `autoprice` gesetzt auf `"usd"`                                                                                                                                                               |
| `auto_renew_allowed`         | `bool`         | Nein          | Erlaube es On-Demand-Bestellungen von Mietern, sich zu deinem aktuellen Preis zu verlängern, wenn sie `mrl`. Lasse es weg, um die gespeicherte Einstellung beizubehalten; ein Server, bei dem dies nie gesetzt wurde, erlaubt Verlängerungen. Ein anderer Wert als `true` oder `false` wird mit Code abgelehnt `2` (HTTP 400) |

> \* **Die Liste der akzeptierten Währungen wird bei jedem Aufruf aus den `enabled-*` Flags neu aufgebaut.** Eine Währung ohne ihr `enabled-<currency>: true` Flag (oder ohne gültigen Preis) wird aus den akzeptierten Währungen des Servers entfernt — wenn alle Flags weggelassen werden, ist der Server in keiner Währung mietbar. Sende immer `enabled-<currency>: true` für jede Währung, die du weiter akzeptieren möchtest.
>
> Die Tagespreise sind je Währung begrenzt: 0,000001–0,1 BTC, 0,1–5.000.000 CLORE, 0,1–10.000 USD.
>
> Wenn eine Währung in USD automatisch bepreist wird, wird ihr aufgelisteter Krypto-Preis aus `usd_pricing` zum aktuellen Wechselkurs abgeleitet (etwa alle 10 Minuten neu berechnet) und jeder `<currency>_on_demand` / `<currency>_spot` gesendete Wert dafür wird ignoriert. Die `usd_pricing` Ziele sind gesamte Server-$-pro-Tag-Werte, validiert gegen den USD-Bereich (0,1 bis 10.000); Werte außerhalb des Bereichs werden auf die nächste Grenze begrenzt.
>
> Mit `auto_renew_allowed` aktiviert (die Standardeinstellung), `mrl` ist auch dein Neupreisungszeitraum: Eine Bestellung, deren Mieter die automatische Verlängerung gewählt hat, verlängert sich jedes Mal, wenn sie `mrl`, zu deinem Preis in diesem Moment. Wenn du es auf `false` setzt, endet eine laufende Miete nie: Jede Bestellung auf dem Server beendet ihre aktuelle Laufzeit und ihre Verlängerung wird abgelehnt mit `host_disallowed`.

**Ausgabe**

| Feld   | Typ   | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode   |

**Beispiel**

**Eingabe:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "name": "Jan Vykydal",
    "availability":true,
    "mrl":96,
    "enabled-bitcoin":true,
    "bitcoin_on_demand":0.0001,
    "bitcoin_spot":0.00000113
}' 'https://api.clore.ai/v1/set_server_settings'
```

**Ausgabe:**

```
{
  "code": 0
}
```

#### 8. `set_spot_price` <a href="#id-8-set_spot_price" id="id-8-set_spot_price"></a>

**Info**

Preis pro Tag für dein SPOT-Marktplatzangebot festlegen

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld                | Typ     | Pflichtangabe | Beschreibung               |
| ------------------- | ------- | ------------- | -------------------------- |
| `order_id`          | `int`   | Ja            | Eindeutige Angebots-ID     |
| `gewünschter_preis` | `float` | Ja            | Dein Angebotspreis pro Tag |

> **Ein Preis unter dem aktuellen Spot-Mindestpreis des Servers** wird mit dem aktuellen Minimum abgelehnt:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
>
> **Eine Erhöhung muss mindestens 1 % über deinem aktuellen Gebot und dem höchsten Gebot des Servers in derselben Währung liegen** (auf die Genauigkeit der Währung aufgerundet, begrenzt durch die Preisobergrenze). Eine kleinere Erhöhung wird mit dem niedrigsten akzeptierten Preis abgelehnt:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Beispiel**

Lass uns versuchen, den Spotmarktpreis zu aktualisieren

**Eingabe 1 (Abwärtsschritt war zu groß):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000200
}' 'https://api.clore.ai/v1/set_spot_price'
```

**Mögliche Ausgabe 1 (Abwärtsschritt war zu groß):**\
Du kannst den Angebotspreis auf dem Spot-Markt um maximal 0,00000100 ₿ senken

| Feld       | Typ            | Beschreibung                                                           |
| ---------- | -------------- | ---------------------------------------------------------------------- |
| `code`     | `int`          | Statuscode                                                             |
| `Fehler`   | `Zeichenkette` | Fehlerbeschreibungsfeld                                                |
| `max_step` | `float`        | Niedrigster möglicher Wert, auf den du den Preis derzeit senken kannst |

```
{
    "error":"exceeded_max_step",
    "max_step":0.0000032,
    "code":6
}
```

**Eingabe 2 (Gültiger Preisschritt nach unten):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000320
}' 'https://api.clore.ai/v1/set_spot_price'
```

**Mögliche Ausgabe 2 (Gültiger Preisschritt nach unten):**

```
{
    "code": 0
}
```

**Eingabe 3 (Den Preis nach Senden von Eingabe 2 noch weiter senken):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000220
}' 'https://api.clore.ai/v1/set_spot_price
```

**Mögliche Ausgabe 3 (Den Preis nach Senden von Eingabe 2 noch weiter senken):**\
Du kannst den Spotpreis einmal alle 600 Sekunden senken

| Feld               | Typ            | Beschreibung                                                               |
| ------------------ | -------------- | -------------------------------------------------------------------------- |
| `code`             | `int`          | Statuscode                                                                 |
| `Fehler`           | `Zeichenkette` | Fehlerbeschreibungsfeld                                                    |
| `time_to_lowering` | `float`        | Verbleibende Zeit (Sek.) bis zur nächsten Möglichkeit, den Preis zu senken |

```
{
    "error":"can_lower_every_600_seconds",
    "time_to_lowering":513,
    "code":6
}
```

#### 9. `cancel_order` <a href="#id-9-cancel_order" id="id-9-cancel_order"></a>

**Info**

Eine aktive Bestellung oder ein Spot-Angebot stornieren

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld      | Typ            | Pflichtangabe | Beschreibung                                                                                                                       |
| --------- | -------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | `int`          | Ja            | Eindeutige Bestell-/Angebots-ID                                                                                                    |
| `Problem` | `Zeichenkette` | Nein          | Wenn du Probleme mit dem Server festgestellt hast, kannst du sie melden an [clore.ai](http://clore.ai/) Team, maximal 2048 Zeichen |

**Ausgabe**

| Feld   | Typ   | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode   |

**Beispiel**

Bestellung/Angebot stornieren

**Eingabe:**\
In diesem Beispiel melden wir Probleme mit GPU #1. Wenn du keine Probleme hast, füge das issue-Feld nicht hinzu.\
Du kannst jede beliebige Nachricht in das Textfeld schreiben, und wir werden sie untersuchen

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"GPU #1 Was overheating and throttling"
}' 'https://api.clore.ai/v1/cancel_order'
```

**Ausgabe:**

```
{
  "code": 0
}
```

#### 10. `create_order` <a href="#id-10-create_order" id="id-10-create_order"></a>

**Info**

Mit diesem Endpunkt kannst du ein Spot-Angebot oder eine On-Demand-Bestellung erstellen

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld                   | Typ            | Pflichtangabe | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------- | -------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Währung`              | `Zeichenkette` | Ja            | Währungsname                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Image`                | `Zeichenkette` | Ja            | Gültiges Image von Docker Hub                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `renting_server`       | `int`          | Ja            | ID des Servers, den du mieten möchtest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `type`                 | `Zeichenkette` | Ja            | `On-Demand` ODER `spot`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `spotprice`            | `float`        | Hängt ab      | Angebotener Preis pro Tag auf dem Spot-Markt, erforderlich beim Erstellen einer Spot-Bestellung                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `ports`                | `Objekt`       | Nein          | Portweiterleitungs-Konfiguration, maximal 5 Einträge                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `env`                  | `Objekt`       | Nein          | <p>Umgebungsvariablen, insgesamt auf 12288 Zeichen begrenzt, wenn sie serialisiert werden.<br>Variablenname - maximal 128 Zeichen, darf nicht enthalten <code>-</code><br>Variablenwert - maximal 1536 Zeichen<br>Nur die ersten 30 gültigen Variablen werden behalten; weitere werden stillschweigend verworfen</p>                                                                                                                                                                                                           |
| `jupyter_token`        | `Zeichenkette` | Nein          | Jupyter-Token für Images mit Jupyter-Notebooks, maximal 32 Zeichen \*                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `ssh_key`              | `Zeichenkette` | Nein          | SSH-Schlüssel für Images mit SSH, maximal 3072 Zeichen \*                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `ssh_password`         | `Zeichenkette` | Nein          | SSH-Passwort für Images mit SSH, maximal 32 Zeichen \*                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `command`              | `Zeichenkette` | Nein          | Der Befehl wird nach dem Erstellen der Bestellung auf dem Server ausgeführt                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `required_price`       | `float`        | Nein          | Gib den Preis an, zu dem du die Bestellung starten möchtest; wenn der Maschinenbesitzer den Preis ändert, startet die Bestellung nicht (nur On-Demand)                                                                                                                                                                                                                                                                                                                                                                         |
| `gpu_count`            | `int`          | Nein          | Anzahl der GPUs, die auf Servern gemietet werden sollen, die [Teilvermietung](https://docs.clore.ai/clore.ai/clore.ai-eng-de/fur-mieter/partial-gpu-rental.md). Lasse es weg, um das gesamte Rig zu mieten. Nur On-Demand, nur homogene Rigs                                                                                                                                                                                                                                                                                   |
| `gpu_indices`          | `[]int`        | Nein          | 0-basierte GPU-Slot-Indizes zum Mieten; die Länge muss gleich `gpu_count`. Nimm freie Slots von `partial_gpu_rental.free_indices`. Lasse es weg, damit das Backend freie GPUs automatisch auswählt                                                                                                                                                                                                                                                                                                                             |
| `autossh_entrypoint`   | `bool`         | Nein          | Verwende den clore.ai-Entrypoint, der automatisch einen SSH-Server und ein benutzerdefiniertes `/root/onstart.sh` Skript                                                                                                                                                                                                                                                                                                                                                                                                       |
| `rental_hours`         | `int`          | Nein          | Nur On-Demand. Wie lange du die Maschine haben möchtest, in ganzen Stunden von 1 bis 3000 (das Plattformmaximum), gezählt ab der Erstellung der Bestellung. Lasse es weg, wenn du kein Limit anfordern willst: Dann endet die Bestellung am `mrl` es sei denn `auto_renew` aktiviert ist; in diesem Fall läuft sie, bis du sie abbrichst. Ein Wert über dem Server `mrl` erfordert `auto_renew: true`; ein Wert auf oder unter diesem Wert beendet die Bestellung nach so vielen Stunden. Wird bei Spot-Bestellungen ignoriert |
| `auto_renew`           | `bool`         | Nein          | Nur On-Demand. Wenn die maximale Mietdauer des Servers erreicht ist, verlängere die Bestellung auf demselben Container zum aktuellen Preis des Servers, solange dieser Preis unter oder gleich `auto_renew_max_price`, bis `rental_hours` verwendet werden, oder bis du abbrichst, wenn `rental_hours` weggelassen wird. Bei einer Verlängerung wird keine Erstellungsgebühr berechnet. Wird bei Spot-Bestellungen und auf Servern abgelehnt, deren `auto_renew_allowed` ist `false`                                           |
| `auto_renew_max_price` | `float`        | Hängt ab      | Erforderlich, wenn `auto_renew` ist `true`. Tagespreisgrenze in der Währung der Bestellung, über 0 und höchstens der maximale Marktplatzpreis für diese Währung (0,1 BTC, 5.000.000 CLORE, 10.000 USD). Bei jeder Verlängerung wird sie mit dem Tagespreis des Servers verglichen, skaliert auf `gpu_count` bei einer Teilmiete                                                                                                                                                                                                |

\* In Felder mit Stern kannst du nur Zeichen aus dieser Regex-Gruppe eingeben `/^[a-zA-Z0-9\s-=.@+/]+$/`

**Ausgabe**

| Feld     | Typ            | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`   | `int`          | Statuscode                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `Fehler` | `Zeichenkette` | Wird mit Code angezeigt `6` (HTTP 200), wenn die Bestellung abgelehnt wird. Ablehnungen der Mietdauer und der automatischen Verlängerung: `invalid_rental_hours` (keine ganze Zahl von 1 bis 3000, oder `null`), `rental_hours_exceeds_mrl` (über der des Servers `mrl` ohne `auto_renew: true`), `invalid_auto_renew` (`auto_renew` ist kein boolescher Wert, oder ist `true` ohne einen positiven `auto_renew_max_price`, oder mit einem über dem maximalen Marktplatzpreis für die Währung), `auto_renew_not_supported` (`auto_renew: true` bei einer Spot-Bestellung), `auto_renew_not_allowed` (der Server erlaubt keine automatische Verlängerung). Ablehnungen von Spot-Geboten werden unten beschrieben |

> **Spot-Gebote unter dem Mindestpreis des Servers** werden mit dem aktuellen Minimum abgelehnt, sodass du sofort erneut versuchen kannst:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Der Mindestpreis wird etwa alle 10 Minuten anhand der aktuellen Kryptokurse neu berechnet, sodass ein aus dem Marktplatz-Eintrag abgelesener Preis leicht veraltet sein kann — verwende immer den zurückgegebenen `min_price` für den erneuten Versuch.
>
> **Wenn der Server bereits Spot-Gebote in derselben Währung hat**, muss ein neues Gebot mindestens 1 % über dem höchsten liegen (auf die Genauigkeit der Währung aufgerundet, begrenzt durch die Preisobergrenze). Ein niedrigeres Gebot wird mit dem niedrigsten akzeptierten Preis abgelehnt:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Beispiel**

**Eingabe 1 (Spot-Angebot erstellen):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"spot",
    "spotprice":0.000001,
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**Ausgabe 1 (Spot-Angebot erstellen):**

```
{
  "code":0
}
```

**Eingabe 2 (Bestellung auf Abruf erstellen):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"on-demand",
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**Ausgabe 2 (Bestellung auf Abruf erstellen):**

```
{
  "code":0
}
```

**Eingabe 3 (Bestellung auf Abruf für 48 Stunden mit automatischer Verlängerung):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"CLORE-Blockchain",
    "image":"cloreai/jupyter:ubuntu24.04-v2",
    "renting_server":6,
    "type":"on-demand",
    "rental_hours":48,
    "auto_renew":true,
    "auto_renew_max_price":250
}' 'https://api.clore.ai/v1/create_order'
```

**Ausgabe 3 (Bestellung auf Abruf für 48 Stunden mit automatischer Verlängerung):**

```
{
  "code":0
}
```

Bei einem Server mit einer 24-Stunden- `mrl` erste Laufzeit dauert 24 Stunden. Am Ende wird die Bestellung für weitere 24 Stunden zum dann aktuellen Preis des Servers verlängert, wenn dieser bei höchstens 250 CLORE pro Tag liegt; danach endet sie, weil die angeforderten 48 Stunden aufgebraucht sind. Mit `auto_renew` an, weglassen von `rental_hours` hält sie so lange weiter verlängert, bis du sie abbrichst. Ohne `auto_renew`, wird dieselbe `rental_hours` auf diesem Server abgelehnt:

```
{ "error": "rental_hours_exceeds_mrl", "code": 6 }
```

#### 11. `Mietergebühren` <a href="#id-11-renter_fees" id="id-11-renter_fees"></a>

**Info**

Aktuelle Gebührenkonfiguration abrufen: Basisgebühren für Mieter, Einstellungen zur PoH-Gebührenermäßigung, Gebühren für das Erstellen von Bestellungen und Ihr PoH-Guthaben

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Ausgabe**

| Feld                               | Typ      | Beschreibung                                                 |
| ---------------------------------- | -------- | ------------------------------------------------------------ |
| `code`                             | `int`    | Statuscode                                                   |
| `renter_fees.on_demand`            | `Objekt` | Basisgebühr (%) pro Währung für On-Demand-Bestellungen       |
| `renter_fees.spot`                 | `Objekt` | Basisgebühr (%) pro Währung für Spot-Bestellungen            |
| `poh_config.max_reduction_percent` | `int`    | Maximale Reduzierung der Basisgebühr durch PoH (%)           |
| `poh_config.max_poh_amount`        | `int`    | PoH-Guthaben, bei dem die maximale Reduzierung erreicht wird |
| `creation_fees.on_demand`          | `Objekt` | Gebühr für das Erstellen von Bestellungen pro Währung        |
| `creation_fees.spot`               | `Objekt` | Gebühr für das Erstellen von Spot-Bestellungen pro Währung   |
| `poh_balance`                      | `float`  | Ihr PoH-CLORE-Guthaben                                       |

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```

**Ausgabe:**

```
{
  "renter_fees": {
    "on_demand": {
      "base": { "bitcoin": 5, "CLORE-Blockchain": 5, "USD-Blockchain": 5 }
    },
    "spot": {
      "base": { "bitcoin": 1.25, "CLORE-Blockchain": 1.25, "USD-Blockchain": 1.25 }
    }
  },
  "poh_config": { "max_reduction_percent": 50, "max_poh_amount": 2000000 },
  "creation_fees": {
    "on_demand": { "bitcoin": 3e-7, "CLORE-Blockchain": 0.5, "USD-Blockchain": 0.1 },
    "spot": { "bitcoin": 1e-7, "CLORE-Blockchain": 0.05, "USD-Blockchain": 0.005 }
  },
  "poh_balance": 5000,
  "code": 0
}
```

#### 12. `cancel_orders` <a href="#id-12-cancel_orders" id="id-12-cancel_orders"></a>

**Info**

Mehrere Bestellungen gleichzeitig abbrechen (bis zu 256 pro Anfrage)

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld        | Typ     | Pflichtangabe | Beschreibung                           |
| ----------- | ------- | ------------- | -------------------------------------- |
| `order_ids` | `[]int` | Ja            | Abzubrechende Bestell-IDs, maximal 256 |

**Ausgabe**

| Feld               | Typ     | Beschreibung                                      |
| ------------------ | ------- | ------------------------------------------------- |
| `code`             | `int`   | Statuscode                                        |
| `failed_to_cancel` | `[]int` | Bestell-IDs, die nicht abgebrochen werden konnten |

**Eingabe:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```

**Ausgabe:**

```
{
  "failed_to_cancel": [],
  "code": 0
}
```

#### 13. `poh_balance` <a href="#id-13-poh_balance" id="id-13-poh_balance"></a>

**Info**

Rufen Sie Ihr Proof-of-Holding-Guthaben ab: Elemente, Summen und Angebotsbeträge des PoH-Marktplatzes

**Header**

| Feld   | Typ            | Pflichtangabe | Beschreibung |
| ------ | -------------- | ------------- | ------------ |
| `auth` | `Zeichenkette` | Ja            | API-Token    |

**Ausgabe**

| Feld                                          | Typ        | Beschreibung                                     |
| --------------------------------------------- | ---------- | ------------------------------------------------ |
| `code`                                        | `int`      | Statuscode                                       |
| `Elemente`                                    | `[]Objekt` | Ihre PoH-Elemente mit einzelnen Guthaben         |
| `balance.total`                               | `float`    | Gesamtes PoH-Guthaben über alle Elemente hinweg  |
| `balance.free_amount`                         | `float`    | PoH-Guthaben, das nicht an Angebote gebunden ist |
| `balance.reward_amount`                       | `float`    | Für Belohnungen berechtigtes Guthaben            |
| `balance.offers.rented_amount`                | `float`    | An andere Nutzer vermieteter Betrag              |
| `balance.offers.rented_on_marketplace_amount` | `float`    | Auf dem PoH-Marktplatz gelisteter Betrag         |
| `balance.offers.leased_amount`                | `float`    | Von anderen Nutzern geleaster Betrag             |

**Eingabe:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```

**Ausgabe:**

```
{
  "items": [ { "balance": 5000 } ],
  "balance": {
    "total": 5000,
    "free_amount": 4000,
    "reward_amount": 5000,
    "offers": {
      "rented_amount": 0,
      "rented_on_marketplace_amount": 1000,
      "rented_finished_amount": 0,
      "leased_amount": 0
    }
  },
  "code": 0
}
```

#### 14. `server-config.json` <a href="#id-14-server-config-json" id="id-14-server-config-json"></a>

**Info**

Statische API-Konfigurationsdaten abrufen. Keine Authentifizierung erforderlich

**Eingabe:**

```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```

#### 15. `get_relay` <a href="#id-15-get_relay" id="id-15-get_relay"></a>

**Info**

TCP-Weiterleitungs-Relay-Knoten für Ihr erkanntes Land abrufen. Keine Authentifizierung erforderlich

**Ausgabe**

| Feld     | Typ            | Beschreibung            |
| -------- | -------------- | ----------------------- |
| `code`   | `int`          | Statuscode              |
| `Land`   | `Zeichenkette` | Erkannter Ländercode    |
| `Knoten` | `Objekt`       | Verfügbare Relay-Knoten |

**Eingabe:**

```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```

#### 16. `set_order_auto_renew` <a href="#id-16-set_order_auto_renew" id="id-16-set_order_auto_renew"></a>

**Info**

Ändern Sie die angeforderte Mietdauer, die automatische Verlängerung und deren Preisgrenze Ihrer aktiven On-Demand-Bestellung. Senden Sie nur die Felder, die Sie ändern möchten; ein weggelassenes Feld behält seinen aktuellen Wert. Nur POST; ein GET antwortet mit Code `4`.

* Die aktuelle Laufzeit endet dann am angeforderten Ende oder bei `term_start + term_mrl`, je nachdem, was zuerst eintritt, und niemals früher als in 60 Sekunden ab jetzt. `mrl` und `term_end` ändern, um zu passen. Das Überschreiten von `term_start + term_mrl` erfordert `auto_renew`, und die Verlängerung am Ende der Laufzeit passt den Preis entsprechend an.
* Eine Verlängerung des Antrags über `term_start + term_mrl` hinaus ist nur möglich, solange `auto_renew` aktiviert ist; andernfalls wird sie abgelehnt mit `rental_hours_exceeds_mrl`. Das Ändern eines gesetzten `rental_hours` zu `null` während `auto_renew` deaktiviert bleibt, zählt als Verlängerung, und eine Änderung, die `auto_renew` deaktiviert, während neue `rental_hours` gesendet werden, deren Ende über `term_start + term_mrl` liegt, wird auf dieselbe Weise abgelehnt.
* Eine Verkürzung des Antrags ohne gleichzeitiges Deaktivieren von `auto_renew` wird in derselben Änderung immer akzeptiert, ebenso das Deaktivieren von `auto_renew` ohne neue Stunden oder mit `rental_hours: null`. Wenn die neuen `rental_hours` bereits aufgebraucht sind, endet die Bestellung etwa eine Minute nach der Änderung. Um eine Miete sofort zu beenden, verwenden Sie [`cancel_order`](#id-9-cancel_order).
* `rental_hours: null` entfernt die angeforderte Grenze: mit `auto_renew` aktiviert läuft die Bestellung dann weiter, bis Sie sie abbrechen.
* Ab 60 Sekunden vor Ende einer Laufzeit bis die Laufzeit verlängert wurde oder die Bestellung beendet wurde, wird die Änderung mit `renewal_in_progress`abgelehnt. Lesen Sie die Bestellung erneut mit [`my_orders`](#id-5-my_orders) und versuchen Sie es erneut.
* Bei einer Bestellung, die vor der Einführung der automatischen Verlängerung erstellt wurde, setzt die erste Änderung `term_start` auf die Erstellungszeit und `term_mrl` auf die `mrl`, sodass sie ohne `auto_renew` nicht über ihr ursprüngliches Ende hinauslaufen kann.

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld                   | Typ             | Pflichtangabe | Beschreibung                                                                                                                                                                                                                                                                   |
| ---------------------- | --------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `order_id`             | `int`           | Ja            | Eindeutige Bestell-ID                                                                                                                                                                                                                                                          |
| `rental_hours`         | `int` \| `null` | Nein          | Neue angeforderte Laufzeit in ganzen Stunden (1 bis 3000), berechnet ab der Erstellung der Bestellung. `null` entfernt die angeforderte Grenze. Lassen Sie sie weg, um den aktuellen Wert beizubehalten                                                                        |
| `auto_renew`           | `bool`          | Nein          | Verlängern zum aktuellen Preis des Hosts, wenn die aktuelle Laufzeit endet. Lassen Sie den Wert weg, um den aktuellen Wert beizubehalten. Das Aktivieren wird abgelehnt, wenn der Server `auto_renew_allowed` ist `false`                                                      |
| `auto_renew_max_price` | `float`         | Hängt ab      | Preislimit pro Tag in der Währung der Bestellung, über 0 und höchstens dem maximalen Marktpreis für diese Währung. Erforderlich, wenn diese Änderung `auto_renew` aktiviert und die Bestellung noch kein Limit hat; andernfalls weglassen, um das aktuelle Limit beizubehalten |

**Ausgabe**

| Feld     | Typ            | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`   | `int`          | Statuscode. `2` (HTTP 400), wenn der Body einen falschen Typ hat, zum Beispiel ein fehlendes oder nicht ganzzahliges `order_id`, `rental_hours` das weder eine ganze Zahl noch `null`, ein nicht-boolescher `auto_renew` oder ein nicht-numerischer `auto_renew_max_price`; dies wird vor jedem untenstehenden Fehler geprüft                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Fehler` | `Zeichenkette` | Wird mit Code angezeigt `6` (HTTP 200): `you_dont_own_this_order` (die Bestellung existiert nicht oder gehört Ihnen nicht), `order_not_active` (eine Spot- oder geschlossene Bestellung, eine Bestellung, die abgebrochen wird, oder eine, die während des Speicherns der Änderung beendet wurde), `renewal_in_progress` (die aktuelle Laufzeit endet innerhalb von 60 Sekunden, oder die Bestellung wurde geändert, während die Änderung gespeichert wurde; lesen Sie die Bestellung erneut und versuchen Sie es erneut), `invalid_rental_hours` (unter 1 oder über 3000), `rental_hours_exceeds_mrl` (siehe die Regeln oben), `invalid_auto_renew` (`auto_renew` (endet mit aktiviert, ohne ein gültiges Preislimit), `auto_renew_not_allowed` (die Änderung aktiviert `auto_renew`  und der Server keine automatische Verlängerung zulässt) |

**Beispiel**

**Eingabe 1 (Bis zum Abbruch weiter verlängern):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "rental_hours":null,
    "auto_renew":true,
    "auto_renew_max_price":30
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**Ausgabe 1 (Bis zum Abbruch weiter verlängern):**

```
{
  "code": 0
}
```

**Eingabe 2 (Verlängerung stoppen, die Bestellung endet mit ihrer aktuellen Laufzeit):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "auto_renew":false
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**Ausgabe 2 (Verlängerung stoppen, die Bestellung endet mit ihrer aktuellen Laufzeit):**

```
{
  "code": 0
}
```

In den letzten 60 Sekunden einer Laufzeit gesendet, wird dieselbe Anfrage abgelehnt, bis die Bestellung verlängert wurde oder beendet ist:

```
{ "error": "renewal_in_progress", "code": 6 }
```

#### 17. `order_renewals` <a href="#id-17-order_renewals" id="id-17-order_renewals"></a>

**Info**

Rufen Sie den Verlaufsverlauf Ihrer Bestellung ab: eine Zeile pro am Ende einer Laufzeit getroffene Verlängerungsentscheidung, verlängert oder abgelehnt, neueste zuerst, höchstens 1000 Zeilen. Eine Bestellung, die nie eine Verlängerungsentscheidung erreicht hat, gibt eine leere Liste zurück, und das Ende, an dem eine Bestellung stoppt, weil ihre angeforderten Stunden aufgebraucht sind, hinterlässt keine Zeile. Nur POST; ein GET antwortet mit Code `4`.

**Header**

| Feld           | Typ            | Pflichtangabe | Beschreibung                 |
| -------------- | -------------- | ------------- | ---------------------------- |
| `auth`         | `Zeichenkette` | Ja            | API-Token                    |
| `Content-type` | `Zeichenkette` | Ja            | Muss sein `application/json` |

**Body**

| Feld       | Typ   | Pflichtangabe | Beschreibung          |
| ---------- | ----- | ------------- | --------------------- |
| `order_id` | `int` | Ja            | Eindeutige Bestell-ID |

**Ausgabe**

| Feld                       | Typ            | Beschreibung                                                                                                                                                                                                                                                                                     |
| -------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                     | `int`          | Statuscode. `2` (HTTP 400), wenn `order_id`  fehlt oder keine ganze Zahl ist                                                                                                                                                                                                                     |
| `Fehler`                   | `Zeichenkette` | `you_dont_own_this_order` mit Code `6` (HTTP 200), wenn die Bestellung nicht existiert oder nicht Ihnen gehört                                                                                                                                                                                   |
| `Verlängerungen`           | `[]Objekt`     | Verlängerungsentscheidungen, neueste zuerst; nur bei Erfolg vorhanden                                                                                                                                                                                                                            |
| `renewals[x].order_id`     | `int`          | Eindeutige Bestell-ID                                                                                                                                                                                                                                                                            |
| `renewals[x].renewal_no`   | `int`          | Die Nummer, die diese Verlängerung unter den Verlängerungen der Bestellung hat oder hätte, beginnend bei 1                                                                                                                                                                                       |
| `renewals[x].outcome`      | `Zeichenkette` | `verlängert` oder `abgelehnt`                                                                                                                                                                                                                                                                    |
| `renewals[x].reason`       | `Zeichenkette` | Nur bei abgelehnten Zeilen: `price_above_cap`, `server_unlisted`, `host_disallowed`, `server_reserved` oder `insufficient_balance` (siehe `orders[x].auto_renew_declined` in [`my_orders`](#id-5-my_orders))                                                                                     |
| `renewals[x].decided_at`   | `int`          | UNIX-Zeit der Entscheidung, getroffen als die Laufzeit beendet war                                                                                                                                                                                                                               |
| `renewals[x].applied_at`   | `int`          | UNIX-Zeit, zu der bestätigt wurde, dass die Verlängerung wirksam wurde. Fehlt bei einer Ablehnung und bei einer Verlängerungsentscheidung, deren Anwendung nicht bestätigt wurde; eine Entscheidung kann unapplied bleiben, wenn die Bestellung im selben Moment abgebrochen oder geändert wurde |
| `renewals[x].old_price`    | `float`        | Tagespreis der beendeten Laufzeit                                                                                                                                                                                                                                                                |
| `renewals[x].new_price`    | `float`        | Tagespreis der neuen Laufzeit oder bei einer Ablehnung der vom Host abgelehnte Preis; fehlt, wenn kein Preis berechnet werden konnte                                                                                                                                                             |
| `renewals[x].cap`          | `float`        | Ihr Tagespreislimit zum Zeitpunkt der Entscheidung                                                                                                                                                                                                                                               |
| `renewals[x].term_seconds` | `int`          | Länge der neuen Laufzeit in Sekunden; `0` bei einer Ablehnung                                                                                                                                                                                                                                    |
| `renewals[x].term_start`   | `int`          | UNIX-Zeit, zu der die neue Laufzeit beginnt (das Ende der vorherigen); bei einer Ablehnung der Beginn der beendeten Laufzeit                                                                                                                                                                     |
| `renewals[x].term_end`     | `int`          | UNIX-Zeit, zu der die neue Laufzeit endet; bei einer Ablehnung das Ende der beendeten Laufzeit                                                                                                                                                                                                   |

**Beispiel**

**Eingabe:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345
}' 'https://api.clore.ai/v1/order_renewals'
```

**Ausgabe:**

In diesem Beispiel wurde die Bestellung einmal zu 24 pro Tag verlängert, innerhalb ihres Limits von 30. Am Ende dieser Laufzeit betrug der Preis des Hosts 36, also über dem Limit, daher wurde die Verlängerung abgelehnt und die Bestellung endete mit dieser Laufzeit.

```
{
  "renewals": [
    {
      "order_id": 12345,
      "renewal_no": 2,
      "outcome": "declined",
      "reason": "price_above_cap",
      "decided_at": 1792209661,
      "old_price": 24,
      "new_price": 36,
      "cap": 30,
      "term_seconds": 0,
      "term_start": 1792188060,
      "term_end": 1792209660
    },
    {
      "order_id": 12345,
      "renewal_no": 1,
      "outcome": "renewed",
      "decided_at": 1792188061,
      "applied_at": 1792188061,
      "old_price": 20,
      "new_price": 24,
      "cap": 30,
      "term_seconds": 21600,
      "term_start": 1792188060,
      "term_end": 1792209660
    }
  ],
  "code": 0
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-de/fur-hosts/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
