_spot` dafür gesendete Wert wird ignoriert. Die `usd_pricing` Zielwerte sind serverweite $/Tag-Werte, die gegen den USD-Bereich (0.1–1,000) validiert werden; Werte außerhalb des Bereichs werden auf die nächste Grenze begrenzt.
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode |
**Beispiel**
Lassen Sie uns einen Sendenachweis für eine Transaktion aus der aktuellen Wallet erstellen.
**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`
**Beschreibung**
Preis pro Tag für Ihr SPOT-Marktplatzangebot festlegen
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------- | -------- | ------------ | ----------------------- |
| `auth` | `string` | Ja | API-Token |
| `Content-Type` | `string` | Ja | Muss `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | ------- | ------------ | ----------------------------- |
| `order_id` | `int` | Ja | Eindeutige Angebots-ID |
| `desired_price` | `float` | Ja | Ihr angebotener Preis pro Tag |
> **Ein Preis unter dem aktuellen Spot-Mindestpreis des Servers** wird mit dem aktuellen Mindestpreis abgelehnt:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
**Beispiel**
Lassen Sie uns versuchen, den Spot-Marktplatzpreis zu aktualisieren
**Eingabe 1 (Schritt nach unten 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 (Schritt nach unten war zu groß):**\
Sie können den Preis des Spot-Marktplatzangebots um höchstens 0.00000100 ₿ senken
| Feld | Typ | Beschreibung |
| ---------- | -------- | ----------------------------------------------------------------------- |
| `code` | `int` | Statuscode |
| `error` | `string` | Feld für Fehlerbeschreibung |
| `max_step` | `float` | Niedrigster möglicher Wert, auf den Sie den Preis derzeit senken können |
```
{
"error":"exceeded_max_step",
"max_step":0.0000032,
"code":6
}
```
**Eingabe 2 (Gültiger Preis-Schritt 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 Preis-Schritt nach unten):**
```
{
"code": 0
}
```
**Eingabe 3 (Preis noch weiter senken, nachdem Eingabe 2 gesendet wurde):**
```
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 (Preis noch weiter senken, nachdem Eingabe 2 gesendet wurde):**\
Sie können den Spot-Preis einmal alle 600 Sekunden senken
| Feld | Typ | Beschreibung |
| ------------------ | -------- | -------------------------------------------------------------------------- |
| `code` | `int` | Statuscode |
| `error` | `string` | Feld für Fehlerbeschreibung |
| `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`
**Beschreibung**
Aktive Bestellung oder Spot-Angebot stornieren
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------- | -------- | ------------ | ----------------------- |
| `auth` | `string` | Ja | API-Token |
| `Content-Type` | `string` | Ja | Muss `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| ------- | -------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `int` | Ja | Eindeutige Bestell-/Angebots-ID |
| `issue` | `string` | Nein | Wenn Sie Probleme mit dem Server festgestellt haben, können Sie sie dem [clore.ai](http://clore.ai/) Team melden, 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 Sie keine Probleme haben, fügen Sie das Feld issue nicht hinzu.\
Sie können in das Textfeld jede beliebige Nachricht 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`
**Beschreibung**
Mit diesem Endpunkt können Sie ein Spot-Angebot oder eine On-Demand-Bestellung erstellen
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------- | -------- | ------------ | ----------------------- |
| `auth` | `string` | Ja | API-Token |
| `Content-Type` | `string` | Ja | Muss `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `string` | Ja | Währungsname |
| `image` | `string` | Ja | Gültiges Image von Docker Hub |
| `renting_server` | `int` | Ja | ID des Servers, den Sie mieten möchten |
| `Typ` | `string` | Ja | `On-Demand` ODER `Spot` |
| `spotprice` | `float` | Hängt ab | Angebotener Preis pro Tag auf dem Spot-Marktplatz, erforderlich beim Erstellen einer Spot-Bestellung |
| `ports` | `object` | Nein | Portweiterleitungs-Konfiguration, max. 5 Einträge |
| `env` | `object` | Nein | Umgebungsvariablen, insgesamt auf 12288 Zeichen begrenzt, wenn als String serialisiert.
Variablenname - maximal 128 Zeichen, darf nicht enthalten -
Variablenwert - maximal 1536 Zeichen
Nur die ersten 30 gültigen Variablen werden beibehalten; zusätzliche werden stillschweigend verworfen
|
| `jupyter_token` | `string` | Nein | Jupyter-Token für Images mit Jupyter-Notebooks, maximal 32 Zeichen \* |
| `ssh_key` | `string` | Nein | SSH-Schlüssel für Images mit SSH, maximal 3072 Zeichen \* |
| `ssh_password` | `string` | Nein | SSH-Passwort für Images mit SSH, maximal 32 Zeichen \* |
| `command` | `string` | Nein | Der Befehl wird nach der Auftragserstellung auf dem Server ausgeführt |
| `required_price` | `float` | Nein | Geben Sie den Preis an, zu dem Sie die Bestellung starten möchten; wenn der Maschinenbesitzer den Preis ändert, wird die Bestellung nicht gestartet (nur On-Demand) |
| `gpu_count` | `int` | Nein | Anzahl der GPUs, die auf Servern gemietet werden sollen, die [Teilvermietung](/clore.ai/clore.ai-eng-de/fur-mieter/partial-gpu-rental.md). Weglassen, um das gesamte Rig zu mieten. Nur On-Demand, nur homogene Rigs |
| `gpu_indices` | `[]int` | Nein | 0-basierte GPU-Slot-Indizes, die gemietet werden sollen; die Länge muss entsprechen `gpu_count`. Freie Slots entnehmen aus `partial_gpu_rental.free_indices`. Weglassen, damit das Backend freie GPUs automatisch auswählt |
| `autossh_entrypoint` | `bool` | Nein | Verwenden Sie den clore.ai-Entrypoint, der automatisch einen SSH-Server und ein benutzerdefiniertes `/root/onstart.sh` Skript |
\* In Felder, die mit einem Stern markiert sind, können Sie nur Zeichen aus dieser Regex-Gruppe eingeben `/^[a-zA-Z0-9\s-=.@+/]+$/`
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------ | ----- | ------------ |
| `code` | `int` | Statuscode |
> **Spot-Gebote unter dem Mindestpreis des Servers** werden mit dem aktuellen Mindestpreis abgelehnt, sodass Sie sofort erneut versuchen können:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Der Mindestpreis wird etwa alle 10 Minuten anhand der aktuellen Coin-Kurse neu berechnet, daher kann ein aus dem Marktplatz-Eintrag abgelesener Preis leicht veraltet sein — verwenden Sie immer den zurückgegebenen `min_price` für den erneuten Versuch.
**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 (On-Demand-Bestellung 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 (On-Demand-Bestellung erstellen):**
```
{
"code":0
}
```
#### 11. `renter_fees`
**Beschreibung**
Rufen Sie die aktuelle Gebührenkonfiguration ab: Basis-Mietergebühren, Einstellungen zur PoH-Gebührenreduzierung, Gebühren für die Auftragserstellung und Ihr PoH-Guthaben
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------- | ------------ | ------------ |
| `auth` | `string` | Ja | API-Token |
**Ausgabe**
| Feld | Typ | Beschreibung |
| ---------------------------------- | -------- | ------------------------------------------------------------ |
| `code` | `int` | Statuscode |
| `renter_fees.on_demand` | `object` | Basisgebühr (%) pro Währung für On-Demand-Bestellungen |
| `renter_fees.spot` | `object` | 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` | `object` | Gebühr für die Auftragserstellung pro Währung |
| `creation_fees.spot` | `object` | Gebühr für die Erstellung 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`
**Beschreibung**
Mehrere Bestellungen gleichzeitig stornieren (bis zu 256 pro Anfrage)
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| -------------- | -------- | ------------ | ----------------------- |
| `auth` | `string` | Ja | API-Token |
| `Content-Type` | `string` | Ja | Muss `application/json` |
**Body**
| Feld | Typ | Erforderlich | Beschreibung |
| ----------- | ------- | ------------ | ---------------------------------------- |
| `order_ids` | `[]int` | Ja | Zu stornierende Bestell-IDs, maximal 256 |
**Ausgabe**
| Feld | Typ | Beschreibung |
| ------------------ | ------- | ----------------------------------------------- |
| `code` | `int` | Statuscode |
| `failed_to_cancel` | `[]int` | Bestell-IDs, die nicht storniert 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`
**Beschreibung**
Rufen Sie Ihr Proof-of-Holding-Guthaben ab: Positionen, Summen und Angebotsbeträge des PoH-Marktplatzes
**Header**
| Feld | Typ | Erforderlich | Beschreibung |
| ------ | -------- | ------------ | ------------ |
| `auth` | `string` | Ja | API-Token |
**Ausgabe**
| Feld | Typ | Beschreibung |
| --------------------------------------------- | ---------- | ------------------------------------------------ |
| `code` | `int` | Statuscode |
| `items` | `[]object` | Ihre PoH-Positionen mit einzelnen Guthaben |
| `balance.total` | `float` | Gesamt-PoH-Guthaben über alle Positionen 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` | Im PoH-Marktplatz aufgeführter Betrag |
| `balance.offers.leased_amount` | `float` | Von anderen Nutzern geliehener 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`
**Beschreibung**
Statische API-Konfigurationsdaten abrufen. Keine Authentifizierung erforderlich
**Eingabe:**
```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```
#### 15. `get_relay`
**Beschreibung**
TCP-Weiterleitungs-Relay-Knoten für Ihr erkanntes Land abrufen. Keine Authentifizierung erforderlich
**Ausgabe**
| Feld | Typ | Beschreibung |
| -------- | -------- | ----------------------- |
| `code` | `int` | Statuscode |
| `Land` | `string` | Erkannter Ländercode |
| `Knoten` | `object` | Verfügbare Relay-Knoten |
**Eingabe:**
```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```
---
# 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=&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.
