> 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-es/para-hosts/api.md).

# API

> 💡 **Desarrolladores de Python:** Usa el SDK oficial [clore-ai Python SDK](https://docs.clore.ai/clore.ai/clore.ai-eng-es/desarrolladores/python-sdk.md) en lugar de llamadas directas a la API. Gestiona la autenticación, el límite de velocidad, los reintentos y el manejo de errores automáticamente.
>
> **Inicio rápido:** `pip install clore-ai` — Consulta la [documentación del SDK de Python](https://docs.clore.ai/clore.ai/clore.ai-eng-es/desarrolladores/python-sdk.md) y [Referencia de la CLI](https://docs.clore.ai/clore.ai/clore.ai-eng-es/desarrolladores/cli-guide.md).

> 🧭 ¿Prefieres una referencia navegable? Abre la documentación interactiva de la API en [clore.ai/api-docs](https://clore.ai/api-docs). URL base para todos los endpoints de esta página: `https://api.clore.ai/v1/`.

<div data-full-width="true"><figure><img src="https://2330542932-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>

### Introducción <a href="#introduction" id="introduction"></a>

[CLORE.AI](http://clore.ai/) la API puede usarse para automatizar despliegues de tus cargas de trabajo en [CLORE.AI](http://clore.ai/)

Primero necesitas obtener una clave de API\
![alt text](https://clore.ai/assets/html/api-export1.png)\
![alt text](https://clore.ai/assets/html/api-export2.png)

***

### Respuestas de la API <a href="#api-responses" id="api-responses"></a>

Las respuestas se devuelven en formato JSON y pueden tener distintos campos

El campo que siempre se devuelve es code, e indica el estado

**campo code**

| code | Descripción                                |
| ---- | ------------------------------------------ |
| `0`  | NORMAL                                     |
| `1`  | ERROR DE BASE DE DATOS                     |
| `2`  | DATOS DE ENTRADA NO VÁLIDOS                |
| `3`  | TOKEN DE API NO VÁLIDO                     |
| `4`  | ENDPOINT NO VÁLIDO                         |
| `5`  | SE SUPERÓ EL LÍMITE DE 1 solicitud/segundo |
| `6`  | Error especificado en `error` campo        |

***

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

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

**Acerca de**

Devuelve billeteras y saldos

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Salida**

| Campo     | Tipo       | Descripción           |
| --------- | ---------- | --------------------- |
| `code`    | `int`      | Código de estado      |
| `wallets` | `[]cadena` | Arreglo de billeteras |

**Ejemplo**

**Entrada:**

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

**Salida:**

```
{
  "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>

**Acerca de**

Devuelve tus servidores que estás proporcionando a [clore.ai](http://clore.ai/) mercado

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Salida**

| Campo                                 | Tipo       | Descripción                                                                                                                                                                                                                                                                                             |
| ------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                                | `int`      | Código de estado                                                                                                                                                                                                                                                                                        |
| `límite`                              | `int`      | Número máximo de servidores que puedes poseer                                                                                                                                                                                                                                                           |
| `servidores`                          | `[]cadena` | Arreglo de servidores                                                                                                                                                                                                                                                                                   |
| `servers[x].name`                     | `cadena`   | Nombre del servidor seleccionado por el usuario                                                                                                                                                                                                                                                         |
| `servers[x].connected`                | `cadena`   | ¿El servidor estuvo conectado alguna vez a [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                 |
| `servers[x].visibility`               | `cadena`   | Visibilidad en el marketplace                                                                                                                                                                                                                                                                           |
| `servers[x].pricing`                  | `[]cadena` | Precio por día bajo demanda                                                                                                                                                                                                                                                                             |
| `servers[x].online`                   | `bool`     | ¿El servidor está en línea                                                                                                                                                                                                                                                                              |
| `servers[x].min_spot_pricing`         | `[]cadena` | Precio mínimo por día para alquilar en el mercado spot                                                                                                                                                                                                                                                  |
| `servers[x].auto_renew_allowed`       | `bool`     | Si los pedidos bajo demanda de los arrendatarios en este servidor pueden renovarse al precio actual cuando alcancen la duración máxima de alquiler. `true` cuando nunca lo configuraste. Ausente en un servidor que se está eliminando. Cámbialo con [`set_server_settings`](#id-7-set_server_settings) |
| `servers[x].init_token`               | `cadena`   | Token de registro de la máquina, devuelto solo hasta que la máquina se inicializa — **trátalo como una credencial**, registra máquinas en tu cuenta                                                                                                                                                     |
| `servers[x].specs`                    | `[]cadena` | Especificaciones del servidor                                                                                                                                                                                                                                                                           |
| `servers[x].remaining_time`           | `int`      | Hora de finalización del alquiler del último pedido activo (época en ms)                                                                                                                                                                                                                                |
| `servers[x].rental_state`             | `cadena`   | Estado agregado del alquiler de GPU: `ninguno`, `parcial`, o `completo`                                                                                                                                                                                                                                 |
| `servers[x].rented_gpus`              | `int`      | GPU actualmente alquiladas en pedidos activos                                                                                                                                                                                                                                                           |
| `servers[x].total_gpus`               | `int`      | GPU totales en el servidor                                                                                                                                                                                                                                                                              |
| `servers[x].rented_price_by_currency` | `objeto`   | Suma de los precios de los pedidos activos, indexada por moneda                                                                                                                                                                                                                                         |
| `servers[x].update_channel`           | `cadena`   | Canal de actualización del agente de alojamiento: `estable` o `beta`                                                                                                                                                                                                                                    |
| `servers[x].requested_channel`        | `cadena`   | Cambio de canal solicitado desde la interfaz web (solo presente cuando se solicita)                                                                                                                                                                                                                     |
| `servers[x].target_backend_version`   | `int`      | Versión del backend a la que apunta el canal actual                                                                                                                                                                                                                                                     |

> Los campos de estado de alquiler (`remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`) están presentes solo mientras el servidor tenga un pedido activo.

**Ejemplo**

**Entrada:**

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

**Salida:**

```
{
  "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
}
```

Los valores en USD de `pricing` objetos reflejan el modo de precios basado en USD, donde el host lo habilitó.

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

**Acerca de**

Obtén la configuración de un servidor específico

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo         | Tipo     | Obligatorio | Descripción         |
| ------------- | -------- | ----------- | ------------------- |
| `server_name` | `cadena` | Sí          | Nombre del servidor |

**Salida**

| Campo                       | Tipo                 | Descripción                                                                                                                                                    |
| --------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                      | `int`                | Código de estado                                                                                                                                               |
| `creation_completed`        | `bool`               | ¿La creación del servidor está completa                                                                                                                        |
| `config`                    | `[]cadena`           | Configuración del servidor                                                                                                                                     |
| `config.name`               | `cadena`             | Nombre del servidor seleccionado por el usuario                                                                                                                |
| `config.connected`          | `bool`               | ¿El servidor estuvo conectado alguna vez a [clore.ai](http://clore.ai/)                                                                                        |
| `config.visibility`         | `cadena`             | Visibilidad en el marketplace                                                                                                                                  |
| `config.pricing`            | `[]cadena`           | Precio por día bajo demanda                                                                                                                                    |
| `config.spot_pricing`       | `[]cadena`           | Precio mínimo por día para alquilar en el mercado spot                                                                                                         |
| `config.mrl`                | `int`                | Duración máxima de alquiler en horas                                                                                                                           |
| `config.auto_renew_allowed` | `bool`               | Si los pedidos bajo demanda de los arrendatarios en este servidor pueden renovarse al precio actual cuando alcancen `mrl`. `true` cuando nunca lo configuraste |
| `config.online`             | `bool`               | ¿El servidor está en línea                                                                                                                                     |
| `config.initialized`        | `bool`               | ¿El servidor estuvo conectado alguna vez a [clore.ai](http://clore.ai/)                                                                                        |
| `config.id`                 | `int`                | ID único del servidor                                                                                                                                          |
| `config.rental_status`      | `int`                | 0 - no alquilado \| 1 - Alquilado en el mercado spot \| 2 - Alquilado bajo demanda \| 3 - Alquiler con precio fijo en USD                                      |
| `config.specs`              | `[]cadena`           | Especificaciones del servidor                                                                                                                                  |
| `config.background_job`     | `objeto`             | Trabajo en segundo plano cuando no está alquilado: `imagen`, `command`, `env`, `times_updated`                                                                 |
| `config.autoprice`          | `objeto` \| `cadena` | Configuración de precio automático por moneda (también pueden aparecer valores de cadena heredados `"pow"` / `"usd"` también aparecen)                         |
| `config.usd_pricing`        | `objeto`             | Objetivos de precio en USD — presentes solo cuando el precio automático en USD está habilitado                                                                 |
| `config.tenants`            | `[]objeto`           | Pedidos activos en el servidor: `rental_type`, `currency`, `precio`, `remaining_time`, `gpu_count`                                                             |

> `server_config` también devuelve los mismos campos de estado de alquiler y canal de actualización que `my_servers`: `remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`, `update_channel`, `requested_channel`, `target_backend_version`. En ambos endpoints, los campos de estado de alquiler están presentes solo mientras el servidor tenga un pedido activo.

**Ejemplo**

**Entrada:**

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

**Salida:**

```
{
  "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
}
```

Los valores en USD de `pricing` objetos reflejan el modo de precios basado en USD, donde el host lo habilitó.

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

**Acerca de**

Obtén el marketplace

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Salida**

| Campo                           | Tipo               | Descripción                                                                                                                                                                                                                                    |
| ------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                          | `int`              | Código de estado                                                                                                                                                                                                                               |
| `my_servers`                    | `[]cadena`         | Arreglo de IDs de servidores que estás proporcionando a [clore.ai](http://clore.ai/) (no se puede alquilar)                                                                                                                                    |
| `servidores`                    | `[]cadena`         | Arreglo de servidores públicos en el marketplace                                                                                                                                                                                               |
| `servers[x].id`                 | `int`              | ID único del servidor                                                                                                                                                                                                                          |
| `servers[x].owner`              | `int`              | ID único del propietario                                                                                                                                                                                                                       |
| `servers[x].mrl`                | `int`              | Duración máxima de alquiler en horas. Cuando el servidor permite la renovación automática, este también es el periodo de reajuste de precio: un pedido que se renueva toma el precio actual del host cada vez que alcanza esta duración        |
| `servers[x].auto_renew_allowed` | `bool`             | Si el host permite la renovación automática en este servidor. `true` cuando el host nunca lo configuró. Cuando `false`, `create_order` con `auto_renew: true` se rechaza con `auto_renew_not_allowed`, y `rental_hours` no puede superar `mrl` |
| `servers[x].price.on_demand`    | `[]cadena`         | Precio por día bajo demanda                                                                                                                                                                                                                    |
| `servers[x].price.spot`         | `[]cadena`         | Precio mínimo por día en el mercado spot                                                                                                                                                                                                       |
| `servers[x].rented`             | `bool`             | ¿El servidor está alquilado bajo demanda                                                                                                                                                                                                       |
| `servers[x].specs`              | `[]cadena`         | Especificaciones del servidor                                                                                                                                                                                                                  |
| `servers[x].partial_gpu_rental` | `objeto` \| `bool` | `false` cuando el alquiler parcial no está disponible; en caso contrario `{ total_gpus, available_gpus, free_indices }`                                                                                                                        |

> `price.on_demand` y `price.spot` incluye solo las monedas que cada servidor realmente acepta — un servidor sin un precio en alguna moneda no puede alquilarse en ella.
>
> El listado es una instantánea en caché, así que un cambio en la `mrl` o `auto_renew_allowed` puede tardar unos minutos en mostrarse aquí.

**Ejemplo**

Obtén el marketplace

**Entrada:**

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

**Salida:**

```
{
  "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>

**Acerca de**

Obtén tus pedidos

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Cadena de consulta**

| Campo              | Tipo   | Obligatorio | Descripción                                  |
| ------------------ | ------ | ----------- | -------------------------------------------- |
| `return_completed` | `bool` | No          | Devuelve los pedidos completados (caducados) |

**Salida**

| Campo                            | Tipo       | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                           | `int`      | Código de estado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `límite`                         | `int`      | Actualmente siempre 999999                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `pedidos`                        | `[]cadena` | Arreglo de pedidos                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].id`                   | `int`      | ID único del pedido                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].creation_fee`         | `float`    | Tarifa de creación pagada a [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].price`                | `float`    | Precio (coste) del pedido por día                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].mrl`                  | `int`      | Segundos desde la creación hasta el final del término actual. Una renovación le añade el nuevo término, así que `ct + mrl` es siempre el final actual                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `orders[x].image`                | `cadena`   | Imagen de Docker utilizada                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `orders[x].currency`             | `cadena`   | Moneda utilizada para la facturación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `orders[x].spend`                | `float`    | Cantidad real debitada hasta ahora: valor acumulado del alquiler más la tarifa base del arrendatario (después de la reducción PoH) y cualquier tarifa adicional; excluye la tarifa única de creación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `orders[x].gpu_count`            | `int`      | Número de GPU que ocupa el pedido (pedidos bajo demanda; equivale al total de GPU del rig salvo que sea un alquiler parcial)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `orders[x].ct`                   | `int`      | Hora de creación (tiempo UNIX)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].p`                    | `int`      | Clúster proxy actualmente utilizado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].specs`                | `[]cadena` | Especificaciones del servidor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `orders[x].si`                   | `int`      | ID único del servidor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `orders[x].pub_cluster`          | `[]cadena` | Endpoints públicos con puertos reenviados                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].tcp_ports`            | `[]cadena` | Reenvío de puertos TCP                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].http_port`            | `cadena`   | Puerto del contenedor reenviado a través de proxy HTTPS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].spot`                 | `bool`     | Indicación de que es un pedido spot                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].expired`              | `bool`     | Indicación de que el pedido ha caducado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].rental_hours`         | `int`      | Horas que solicitaste, contadas desde la creación (solo bajo demanda). Ausente cuando no se solicitó ningún límite: el pedido termina entonces en la duración máxima de alquiler del host, a menos que `auto_renew` esté activada, en cuyo caso se ejecuta hasta que canceles                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `orders[x].rental_end`           | `int`      | Tiempo UNIX en que se agotan las horas solicitadas; ausente cuando no se solicitó ningún límite                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].term_start`           | `int`      | Tiempo UNIX en que comenzó el término actual (creación o la última renovación)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].term_end`             | `int`      | Tiempo UNIX en que termina el término actual; siempre `ct + mrl`. Ausente en pedidos spot y en un pedido bajo demanda creado antes de que existiera la renovación automática y que nunca se haya editado desde entonces                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `orders[x].term_mrl`             | `int`      | La duración máxima de alquiler del host, en segundos, cuando comenzó el término actual. [`set_order_auto_renew`](#id-16-set_order_auto_renew) puede extender el término actual hasta `term_start + term_mrl`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `orders[x].last_renewal_at`      | `int`      | Tiempo UNIX en que se aplicó la última renovación; ausente antes de la primera renovación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders[x].auto_renew`           | `bool`     | Si el pedido se renueva al precio actual del host cuando termina el término actual. Se establece en `false` cuando se rechaza una renovación. Ausente en un pedido creado sin renovación automática y nunca editado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].auto_renew_max_price` | `float`    | Tu límite de precio por día para renovaciones, en la moneda del pedido. Se rechaza una renovación cuando el precio del host está por encima de él                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].renewals_count`       | `int`      | Número de renovaciones aplicadas hasta ahora; ausente antes de la primera renovación                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `orders[x].pending_renewal`      | `objeto`   | Presente mientras una renovación está programada para el final del término actual: `precio` (`float`, el precio por día del siguiente término) y `term_seconds` (`int`, la duración en segundos del siguiente término)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].auto_renew_declined`  | `objeto`   | Se presenta después de que se rechazara una renovación: `razón` y `en` (hora UNIX de la decisión). El pedido termina con su período actual. `razón` es uno de `price_above_cap` (el nuevo precio diario del anfitrión está por encima de `auto_renew_max_price`), `server_unlisted` (el servidor está oculto o se está eliminando, ya no acepta la moneda del pedido o no tiene precio en ella, o ya no supera las comprobaciones de salud que debe pasar un pedido nuevo), `host_disallowed` (el anfitrión desactivó la renovación automática), `server_reserved` (el servidor está reservado para otro arrendatario) o `insufficient_balance` (después de pagar el tiempo hasta el final del período, tu saldo cubriría menos de una hora al nuevo precio) |

> Cada pedido bajo demanda creado desde que se lanzó la renovación automática lleva `term_start`, `term_end` y `term_mrl`. Los demás campos de renovación aparecen solo cuando aplican: `rental_hours` y `rental_end` cuando se solicitaron horas, `auto_renew` y `auto_renew_max_price` cuando la renovación automática se solicitó al crear el pedido o se configuró mediante [`set_order_auto_renew`](#id-16-set_order_auto_renew), y `renewals_count` y `last_renewal_at` después de la primera renovación. Véase [Duración del alquiler y renovación automática](https://docs.clore.ai/clore.ai/clore.ai-eng-es/para-arrendatarios/order-management.md#rental-length-and-auto-renewal).

**Entrada:**

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

El primer pedido a continuación es un pedido bajo demanda en un servidor con una duración máxima de alquiler de 73 horas (`mrl` de 262800 segundos), creado con `rental_hours: 120` y con la renovación automática activada, y aún en su primer período. El segundo es un pedido spot caducado.

**Salida:**

```
{
  "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>

**Acerca de**

Obtener el mercado spot para un servidor específico

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Cadena de consulta**

| Campo     | Tipo  | Obligatorio | Descripción           |
| --------- | ----- | ----------- | --------------------- |
| `mercado` | `int` | Sí          | ID único del servidor |

**Salida**

| Campo                          | Tipo      | Descripción                                                  |
| ------------------------------ | --------- | ------------------------------------------------------------ |
| `code`                         | `int`     | Código de estado                                             |
| `existe`                       | `bool`    | Verificación de que el mercado existe                        |
| `mercado`                      | `objeto`  | Marketplace                                                  |
| `market.offers`                | `arreglo` | Ofertas de alquiler para el servidor                         |
| `market.offers[x].offer_id`    | `int`     | ID único de la oferta                                        |
| `market.offers[x].bid`         | `float`   | Precio ofrecido por día (en la moneda de la oferta)          |
| `market.offers[x].currency`    | `cadena`  | Moneda de la oferta                                          |
| `market.offers[x].active`      | `bool`    | Esta oferta se está usando actualmente                       |
| `market.offers[x].my`          | `bool`    | Esta oferta me pertenece                                     |
| `market.server`                | `objeto`  | Información del servidor                                     |
| `market.server.min_pricing`    | `objeto`  | Precio mínimo de la oferta por día, por cada moneda aceptada |
| `market.server.mrl`            | `int`     | Duración máxima de alquiler en **horas**                     |
| `market.server.visibility`     | `cadena`  | Solo puedes crear ofertas cuando la visibilidad es pública   |
| `market.server.online`         | `bool`    | El servidor está en línea                                    |
| `market.currency_rates_in_usd` | `objeto`  | Tasas USD en vivo usadas para comparar ofertas entre monedas |

> Las ofertas pueden realizarse en cualquier moneda que acepte el servidor; las ofertas competidoras se comparan por su **valor en USD** (usando `currency_rates_in_usd`), no su valor nominal.
>
> ⚠️ **Cambiado en agosto de 2026:** `market.server.mrl` ahora se devuelve en **horas** (antes en segundos). Un valor que decía `262800` ahora dice `73`.

**Entrada:**

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

**Salida:**

```
{
  "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>

**Acerca de**

Configura los ajustes del servidor que estás ofreciendo en [clore.ai](http://clore.ai/) mercado

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo                        | Tipo     | Obligatorio | Descripción                                                                                                                                                                                                                                                                                         |
| ---------------------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                       | `cadena` | Sí          | Nombre del servidor seleccionado por el usuario                                                                                                                                                                                                                                                     |
| `disponibilidad`             | `bool`   | Sí          | ¿Se puede alquilar el servidor?                                                                                                                                                                                                                                                                     |
| `mrl`                        | `int`    | Sí          | Duración máxima de alquiler del servidor en **horas** (6 a 3000)                                                                                                                                                                                                                                    |
| `bitcoin_on_demand`          | `float`  | Sí          | Precio bajo demanda en BTC por día                                                                                                                                                                                                                                                                  |
| `bitcoin_spot`               | `float`  | Sí          | Precio mínimo spot en BTC por día                                                                                                                                                                                                                                                                   |
| `CLORE-Blockchain_on_demand` | `float`  | No          | Precio bajo demanda en CLORE por día                                                                                                                                                                                                                                                                |
| `CLORE-Blockchain_spot`      | `float`  | No          | Precio mínimo spot en CLORE por día                                                                                                                                                                                                                                                                 |
| `USD-Blockchain_on_demand`   | `float`  | No          | Precio bajo demanda en USD por día                                                                                                                                                                                                                                                                  |
| `USD-Blockchain_spot`        | `float`  | No          | Precio mínimo spot en USD por día                                                                                                                                                                                                                                                                   |
| `enabled-bitcoin`            | `bool`   | No\*        | Aceptar Bitcoin para este servidor                                                                                                                                                                                                                                                                  |
| `enabled-CLORE-Blockchain`   | `bool`   | No\*        | Aceptar CLORE para este servidor                                                                                                                                                                                                                                                                    |
| `enabled-USD-Blockchain`     | `bool`   | No\*        | Aceptar stablecoins USD para este servidor                                                                                                                                                                                                                                                          |
| `autoprice`                  | `objeto` | No          | Autopreciación por moneda: establece una clave de moneda (`bitcoin`, `CLORE-Blockchain`) a `"usd"` para la autopreciación basada en USD o `false` para precio fijo                                                                                                                                  |
| `usd_pricing`                | `objeto` | No          | Objetivos de precio en USD por moneda, p. ej. `{ "bitcoin": { "on_demand": 10, "spot": 5 } }` — usado solo para monedas con `autoprice` configurado en `"usd"`                                                                                                                                      |
| `auto_renew_allowed`         | `bool`   | No          | Permite que los pedidos bajo demanda de los arrendatarios se renueven a tu precio actual cuando alcancen `mrl`. Omítelo para conservar el ajuste almacenado; un servidor que nunca lo configuró permite renovaciones. Un valor distinto de `true` o `false` se rechaza con el código `2` (HTTP 400) |

> \* **La lista de monedas aceptadas se reconstruye a partir de las `enabled-*` indicadores en cada llamada.** Una moneda sin su `enabled-<currency>: true` indicador (o sin un precio válido) se elimina de las monedas aceptadas del servidor — omitir todos los indicadores deja el servidor no alquilable en ninguna moneda. Envía siempre `enabled-<currency>: true` para cada moneda que quieras seguir aceptando.
>
> Los precios por día tienen un tope por moneda: 0.000001–0.1 BTC, 0.1–5,000,000 CLORE, 0.1–10,000 USD.
>
> Cuando una moneda tiene precio automático en USD, su precio cripto publicado se deriva de `usd_pricing` al tipo de cambio en vivo (recalculado aproximadamente cada 10 minutos) y cualquier `<currency>_on_demand` / `<currency>_spot` valor enviado para ella se ignora. Los `usd_pricing` objetivos son cifras de $/día para todo el servidor validadas frente al rango en USD (0.1 a 10,000); los valores fuera de rango se ajustan al límite más cercano.
>
> Con `auto_renew_allowed` activado (el valor predeterminado), `mrl` también es tu período de reajuste de precio: un pedido cuyo arrendatario eligió renovación automática se renueva cada vez que alcanza `mrl`, al precio que tengas en ese momento. Configurarlo en `false` nunca termina un alquiler en curso: cada pedido en el servidor finaliza su período actual y su renovación se rechaza con `host_disallowed`.

**Salida**

| Campo  | Tipo  | Descripción      |
| ------ | ----- | ---------------- |
| `code` | `int` | Código de estado |

**Ejemplo**

**Entrada:**

```
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'
```

**Salida:**

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

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

**Acerca de**

Establece el precio por día de tu oferta del mercado SPOT

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo           | Tipo    | Obligatorio | Descripción                |
| --------------- | ------- | ----------- | -------------------------- |
| `order_id`      | `int`   | Sí          | ID único de la oferta      |
| `desired_price` | `float` | Sí          | Tu precio ofrecido por día |

> **Un precio por debajo del mínimo spot actual del servidor** se rechaza junto con el mínimo actual incluido:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
>
> **Un aumento debe ser al menos un 1 % superior tanto a tu oferta actual como a la oferta más alta del servidor en la misma moneda** (redondeado al alza a la precisión de la moneda, limitado al tope de precio). Un aumento menor se rechaza con el precio mínimo aceptado:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Ejemplo**

Intentemos actualizar el precio del mercado spot

**Entrada 1 (La bajada fue demasiado grande):**

```
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'
```

**Posible salida 1 (La bajada fue demasiado grande):**\
Puedes bajar el precio de la oferta del mercado spot como máximo en 0.00000100 ₿

| Campo      | Tipo     | Descripción                                                             |
| ---------- | -------- | ----------------------------------------------------------------------- |
| `code`     | `int`    | Código de estado                                                        |
| `error`    | `cadena` | Campo de descripción del error                                          |
| `max_step` | `float`  | El valor mínimo posible hasta el que puedes bajar el precio actualmente |

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

**Entrada 2 (Bajada de precio válida):**

```
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'
```

**Posible salida 2 (Bajada de precio válida):**

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

**Entrada 3 (Bajar el precio aún más después de enviar la Entrada 2):**

```
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
```

**Posible salida 3 (Bajar el precio aún más después de enviar la Entrada 2):**\
Puedes bajar el precio spot una vez cada 600 segundos

| Campo              | Tipo     | Descripción                                                           |
| ------------------ | -------- | --------------------------------------------------------------------- |
| `code`             | `int`    | Código de estado                                                      |
| `error`            | `cadena` | Campo de descripción del error                                        |
| `time_to_lowering` | `float`  | Tiempo restante (seg) hasta la próxima posibilidad de bajar el precio |

```
{
    "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>

**Acerca de**

Cancela un pedido activo o una oferta spot

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo      | Tipo     | Obligatorio | Descripción                                                                                                                          |
| ---------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `id`       | `int`    | Sí          | ID único del pedido/oferta                                                                                                           |
| `problema` | `cadena` | No          | Si has encontrado algún problema con el servidor, puedes informarlo a [clore.ai](http://clore.ai/) al equipo, máximo 2048 caracteres |

**Salida**

| Campo  | Tipo  | Descripción      |
| ------ | ----- | ---------------- |
| `code` | `int` | Código de estado |

**Ejemplo**

Cancelar pedido/oferta

**Entrada:**\
En este ejemplo estamos informando problemas con la GPU #1; si no tienes problemas, no incluyas el campo issue.\
Puedes escribir cualquier mensaje en el campo text y lo investigaremos

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"La GPU #1 se sobrecalentaba y reducía su rendimiento"
}' 'https://api.clore.ai/v1/cancel_order'
```

**Salida:**

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

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

**Acerca de**

Puedes crear una oferta spot o un pedido bajo demanda con este endpoint

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo                  | Tipo     | Obligatorio | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------- | -------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency`             | `cadena` | Sí          | Nombre de la moneda                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `imagen`               | `cadena` | Sí          | Imagen válida de Docker Hub                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `renting_server`       | `int`    | Sí          | ID del servidor que quieres alquilar                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `type`                 | `cadena` | Sí          | `bajo demanda` O `spot`                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `spotprice`            | `float`  | Depende     | Precio ofrecido por día en el mercado spot, requerido al crear un pedido spot                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `ports`                | `objeto` | No          | Configuración de reenvío de puertos, máximo 5 registros                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `env`                  | `objeto` | No          | <p>Variables de entorno, limitadas a 12288 caracteres en total al serializarse.<br>Nombre de variable - máximo 128 caracteres, no debe contener <code>-</code><br>Valor de variable - máximo 1536 caracteres<br>Solo se conservan las primeras 30 variables válidas; las demás se descartan silenciosamente</p>                                                                                                                                                                                      |
| `jupyter_token`        | `cadena` | No          | Token de Jupyter para imágenes que tienen notebooks de Jupyter, máximo 32 caracteres \*                                                                                                                                                                                                                                                                                                                                                                                                              |
| `ssh_key`              | `cadena` | No          | Clave SSH para imágenes con SSH, máximo 3072 caracteres \*                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `ssh_password`         | `cadena` | No          | Contraseña SSH para imágenes con SSH, máximo 32 caracteres \*                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `command`              | `cadena` | No          | El comando se ejecutará en el servidor después de crear el pedido                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `required_price`       | `float`  | No          | Especifica el precio al que quieres iniciar el pedido; si el propietario de la máquina cambia el precio, entonces el pedido no se iniciará (solo bajo demanda)                                                                                                                                                                                                                                                                                                                                       |
| `gpu_count`            | `int`    | No          | Número de GPU a alquilar en servidores que soportan [alquiler parcial](https://docs.clore.ai/clore.ai/clore.ai-eng-es/para-arrendatarios/partial-gpu-rental.md). Omítelo para alquilar todo el rig. Solo bajo demanda, solo rigs homogéneos                                                                                                                                                                                                                                                          |
| `gpu_indices`          | `[]int`  | No          | Índices de ranura de GPU con base 0 para alquilar; la longitud debe ser igual a `gpu_count`. Toma ranuras libres de `partial_gpu_rental.free_indices`. Omítelo para que el backend elija automáticamente las GPU libres                                                                                                                                                                                                                                                                              |
| `autossh_entrypoint`   | `bool`   | No          | Usa el punto de entrada de clore.ai, que despliega automáticamente un servidor SSH y personalizado `/root/onstart.sh` script                                                                                                                                                                                                                                                                                                                                                                         |
| `rental_hours`         | `int`    | No          | Solo bajo demanda. Durante cuánto tiempo quieres la máquina, en horas enteras de 1 a 3000 (el máximo de la plataforma), contadas desde la creación del pedido. Omítelo para no solicitar límite: el pedido entonces termina en el servidor `mrl` a menos que `auto_renew` esté activado, en cuyo caso se ejecuta hasta que canceles. Un valor superior al `mrl` requiere `auto_renew: true`; un valor igual o inferior termina el pedido después de esa cantidad de horas. Se ignora en pedidos spot |
| `auto_renew`           | `bool`   | No          | Solo bajo demanda. Cuando se alcance la duración máxima de alquiler del servidor, renueva el pedido en el mismo contenedor al precio actual del servidor, siempre que ese precio sea igual o inferior a `auto_renew_max_price`, hasta que `rental_hours` se usen, o hasta que canceles cuando `rental_hours` se omita. No se cobra tarifa de creación por una renovación. Se rechaza en pedidos spot y en servidores cuyo `auto_renew_allowed` es `false`                                            |
| `auto_renew_max_price` | `float`  | Depende     | Requerido cuando `auto_renew` es `true`. Límite de precio por día en la moneda del pedido, mayor que 0 y como máximo el precio máximo del mercado para esa moneda (0.1 BTC, 5,000,000 CLORE, 10,000 USD). En cada renovación se compara con el precio diario del servidor, escalado a `gpu_count` en un alquiler parcial                                                                                                                                                                             |

\* En los campos marcados con asterisco solo puedes introducir caracteres de este grupo regexp `/^[a-zA-Z0-9\s-=.@+/]+$/`

**Salida**

| Campo   | Tipo     | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`  | `int`    | Código de estado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `error` | `cadena` | Se presenta con el código `6` (HTTP 200) cuando se rechaza el pedido. Rechazos de duración de alquiler y renovación automática: `invalid_rental_hours` (no es un número entero de 1 a 3000, o `null`), `rental_hours_exceeds_mrl` (por encima del `mrl` sin `auto_renew: true`), `invalid_auto_renew` (`auto_renew` no es un booleano, o es `true` sin un positivo `auto_renew_max_price`, o con uno superior al precio máximo del mercado para la moneda), `auto_renew_not_supported` (`auto_renew: true` en un pedido spot), `auto_renew_not_allowed` (el servidor no permite la renovación automática). Los rechazos de ofertas spot se describen a continuación |

> **Las ofertas spot por debajo del mínimo del servidor** se rechazan con el mínimo actual incluido, para que puedas volver a intentarlo de inmediato:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> El mínimo se recalcula a partir de las tasas de las monedas en vivo aproximadamente cada 10 minutos, así que un precio leído de la lista del mercado puede estar un poco desactualizado — usa siempre el `min_price` para el reintento.
>
> **Cuando el servidor ya tiene ofertas spot en la misma moneda**, una nueva oferta debe ser al menos un 1 % superior a la superior (redondeada al alza a la precisión de la moneda, limitada al tope de precio). Una oferta inferior se rechaza con el precio mínimo aceptado:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**Ejemplo**

**Entrada 1 (Crear oferta spot):**

```
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'
```

**Salida 1 (Crear oferta spot):**

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

**Entrada 2 (Crear orden bajo demanda):**

```
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'
```

**Salida 2 (Crear orden bajo demanda):**

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

**Entrada 3 (Orden bajo demanda durante 48 horas con renovación automática):**

```
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'
```

**Salida 3 (Orden bajo demanda durante 48 horas con renovación automática):**

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

En un servidor con un periodo de 24 horas `mrl` el primer periodo dura 24 horas. Al final, la orden se renueva por otras 24 horas al precio del servidor en ese momento, si es igual o inferior a 250 CLORE por día; luego termina porque se agotan las 48 horas solicitadas. Con `auto_renew` activado, omitir `rental_hours` la mantiene renovándose hasta que la canceles. Sin `auto_renew`, el mismo `rental_hours` en ese servidor se rechaza:

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

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

**Acerca de**

Obtén la configuración actual de comisiones: comisiones base del arrendatario, ajustes de reducción de comisiones por PoH, comisiones de creación de órdenes y tu saldo PoH

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Salida**

| Campo                              | Tipo     | Descripción                                            |
| ---------------------------------- | -------- | ------------------------------------------------------ |
| `code`                             | `int`    | Código de estado                                       |
| `renter_fees.on_demand`            | `objeto` | Comisión base (%) por moneda para órdenes bajo demanda |
| `renter_fees.spot`                 | `objeto` | Comisión base (%) por moneda para órdenes spot         |
| `poh_config.max_reduction_percent` | `int`    | Reducción máxima de la comisión base mediante PoH (%)  |
| `poh_config.max_poh_amount`        | `int`    | Saldo PoH al que se alcanza la reducción máxima        |
| `creation_fees.on_demand`          | `objeto` | Comisión de creación de órdenes por moneda             |
| `creation_fees.spot`               | `objeto` | Comisión de creación de órdenes spot por moneda        |
| `poh_balance`                      | `float`  | Tu saldo PoH en CLORE                                  |

**Entrada:**

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

**Salida:**

```
{
  "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>

**Acerca de**

Cancela varias órdenes a la vez (hasta 256 por solicitud)

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo       | Tipo    | Obligatorio | Descripción                                      |
| ----------- | ------- | ----------- | ------------------------------------------------ |
| `order_ids` | `[]int` | Sí          | IDs de órdenes que se van a cancelar, máximo 256 |

**Salida**

| Campo              | Tipo    | Descripción                                |
| ------------------ | ------- | ------------------------------------------ |
| `code`             | `int`   | Código de estado                           |
| `failed_to_cancel` | `[]int` | IDs de órdenes que no se pudieron cancelar |

**Entrada:**

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

**Salida:**

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

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

**Acerca de**

Obtén el saldo de tu Proof of Holding: elementos, totales e importes de oferta del Mercado PoH

**Encabezados**

| Campo  | Tipo     | Obligatorio | Descripción  |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí          | Token de API |

**Salida**

| Campo                                         | Tipo       | Descripción                               |
| --------------------------------------------- | ---------- | ----------------------------------------- |
| `code`                                        | `int`      | Código de estado                          |
| `elementos`                                   | `[]objeto` | Tus elementos PoH con saldos individuales |
| `balance.total`                               | `float`    | Saldo total de PoH en todos los elementos |
| `balance.free_amount`                         | `float`    | Saldo PoH no comprometido en ofertas      |
| `balance.reward_amount`                       | `float`    | Saldo elegible para recompensas           |
| `balance.offers.rented_amount`                | `float`    | Importe alquilado a otros usuarios        |
| `balance.offers.rented_on_marketplace_amount` | `float`    | Importe listado en el Mercado PoH         |
| `balance.offers.leased_amount`                | `float`    | Importe arrendado de otros usuarios       |

**Entrada:**

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

**Salida:**

```
{
  "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>

**Acerca de**

Obtén datos estáticos de configuración de la API. No se requiere autenticación

**Entrada:**

```
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>

**Acerca de**

Obtén nodos de retransmisión para reenvío TCP de tu país detectado. No se requiere autenticación

**Salida**

| Campo   | Tipo     | Descripción                        |
| ------- | -------- | ---------------------------------- |
| `code`  | `int`    | Código de estado                   |
| `país`  | `cadena` | Código de país detectado           |
| `nodos` | `objeto` | Nodos de retransmisión disponibles |

**Entrada:**

```
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>

**Acerca de**

Cambia la duración del alquiler solicitada, la renovación automática y su límite de precio de tu orden activa bajo demanda. Envía solo los campos que quieras cambiar; un campo omitido conserva su valor actual. Solo POST; un GET responde código `4`.

* El periodo actual termina entonces en el final solicitado o en `term_start + term_mrl`, lo que ocurra primero, y nunca antes de 60 segundos a partir de ahora. `mrl` y `term_end` cambia para coincidir. Ejecutarse más allá de `term_start + term_mrl` necesita `auto_renew`, y la renovación al final del periodo lo recalcula.
* Alargar la solicitud más allá de `term_start + term_mrl` solo es posible mientras `auto_renew` esté activado; de lo contrario se rechaza con `rental_hours_exceeds_mrl`. Cambiar un `rental_hours` a `null` mientras `auto_renew` permanece desactivado cuenta como alargar, y una edición que activa `auto_renew` desactivado mientras envía nuevas `rental_hours` que terminan después de `term_start + term_mrl` se rechaza del mismo modo.
* Acortar la solicitud sin desactivar `auto_renew` en el mismo cambio siempre se acepta, y también se acepta desactivar `auto_renew` sin nuevas horas o con `rental_hours: null`. Si las nuevas `rental_hours` ya se han agotado, la orden termina aproximadamente un minuto después del cambio. Para detener un alquiler de inmediato, usa [`cancel_order`](#id-9-cancel_order).
* `rental_hours: null` elimina el límite solicitado: con `auto_renew` activado, la orden entonces sigue hasta que la canceles.
* Desde 60 segundos antes del final de un periodo hasta que el periodo se haya renovado o la orden haya terminado, el cambio se rechaza con `renewal_in_progress`. Vuelve a leer la orden con [`my_orders`](#id-5-my_orders) y vuelve a intentarlo.
* En una orden creada antes de que se lanzara la renovación automática, el primer cambio establece `term_start` en el momento de la creación y `term_mrl` al de la orden `mrl`, así que sin `auto_renew` no puede ir más allá de su final original.

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo                  | Tipo            | Obligatorio | Descripción                                                                                                                                                                                                                                                           |
| ---------------------- | --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | `int`           | Sí          | ID único del pedido                                                                                                                                                                                                                                                   |
| `rental_hours`         | `int` \| `null` | No          | Nueva duración solicitada en horas completas (1 a 3000), contada desde la creación de la orden. `null` elimina el límite solicitado. Omítelo para conservar el valor actual                                                                                           |
| `auto_renew`           | `bool`          | No          | Renovar al precio actual del anfitrión cuando termine el periodo actual. Omítelo para conservar el valor actual. Activarlo se rechaza cuando el servidor `auto_renew_allowed` es `false`                                                                              |
| `auto_renew_max_price` | `float`         | Depende     | Límite de precio por día en la moneda de la orden, mayor que 0 y como máximo el precio máximo del mercado para esa moneda. Obligatorio cuando este cambio activa `auto_renew` y la orden aún no tiene límite; de lo contrario omítelo para conservar el límite actual |

**Salida**

| Campo   | Tipo     | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`  | `int`    | Código de estado. `2` (HTTP 400) cuando el cuerpo tiene un tipo incorrecto, por ejemplo un `order_id`, `rental_hours` que no sea un número entero ni `null`, un `auto_renew` no booleano `auto_renew_max_price`o un                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `error` | `cadena` | Se presenta con el código `6` (HTTP 200): `you_dont_own_this_order` (la orden no existe o no es tuya), `order_not_active` (una orden spot o cerrada, una orden que se está cancelando o una que terminó mientras se guardaba el cambio), `renewal_in_progress` (el periodo actual termina en menos de 60 segundos, o la orden cambió mientras se guardaba el cambio; vuelve a leer la orden e inténtalo de nuevo), `invalid_rental_hours` (por debajo de 1 o por encima de 3000), `rental_hours_exceeds_mrl` (consulta las reglas anteriores), `invalid_auto_renew` (`auto_renew` termina activado sin un límite de precio válido), `auto_renew_not_allowed` (el cambio activa `auto_renew` y el servidor no permite la renovación automática) |

**Ejemplo**

**Entrada 1 (Seguir renovando hasta cancelar):**

```
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'
```

**Salida 1 (Seguir renovando hasta cancelar):**

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

**Entrada 2 (Dejar de renovar, la orden termina con su periodo actual):**

```
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'
```

**Salida 2 (Dejar de renovar, la orden termina con su periodo actual):**

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

Si se envía en los últimos 60 segundos de un periodo, la misma solicitud se rechaza hasta que la orden se haya renovado o haya terminado:

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

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

**Acerca de**

Obtén el historial de renovaciones de tu orden: una fila por cada decisión de renovación tomada al final de un periodo, renovada o rechazada, la más reciente primero, como máximo 1000 filas. Una orden que nunca llegó a una decisión de renovación devuelve una lista vacía, y el final en el que una orden se detiene porque se agotan sus horas solicitadas no deja ninguna fila. Solo POST; un GET responde código `4`.

**Encabezados**

| Campo               | Tipo     | Obligatorio | Descripción                 |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth`              | `cadena` | Sí          | Token de API                |
| `Tipo de contenido` | `cadena` | Sí          | Debe ser `application/json` |

**Cuerpo**

| Campo      | Tipo  | Obligatorio | Descripción         |
| ---------- | ----- | ----------- | ------------------- |
| `order_id` | `int` | Sí          | ID único del pedido |

**Salida**

| Campo                      | Tipo       | Descripción                                                                                                                                                                                                                                |
| -------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                     | `int`      | Código de estado. `2` (HTTP 400) cuando `order_id` falta o no es un entero                                                                                                                                                                 |
| `error`                    | `cadena`   | `you_dont_own_this_order` con código `6` (HTTP 200) cuando la orden no existe o no es tuya                                                                                                                                                 |
| `renovaciones`             | `[]objeto` | Decisiones de renovación, más recientes primero; presentes solo en caso de éxito                                                                                                                                                           |
| `renewals[x].order_id`     | `int`      | ID único del pedido                                                                                                                                                                                                                        |
| `renewals[x].renewal_no`   | `int`      | El número que tiene, o tendría, esta renovación entre las renovaciones de la orden, contando desde 1                                                                                                                                       |
| `renewals[x].outcome`      | `cadena`   | `renovada` o `rechazada`                                                                                                                                                                                                                   |
| `renewals[x].reason`       | `cadena`   | Solo filas rechazadas: `price_above_cap`, `server_unlisted`, `host_disallowed`, `server_reserved` o `insufficient_balance` (véase `orders[x].auto_renew_declined` en [`my_orders`](#id-5-my_orders))                                       |
| `renewals[x].decided_at`   | `int`      | Tiempo UNIX de la decisión, tomada cuando el periodo había terminado                                                                                                                                                                       |
| `renewals[x].applied_at`   | `int`      | Tiempo UNIX en que se confirmó que la renovación entró en vigor. Ausente en una negativa y en una decisión de renovación que no se confirmó; una decisión puede quedar sin aplicar cuando la orden se canceló o cambió en el mismo momento |
| `renewals[x].old_price`    | `float`    | Precio por día del periodo que terminó                                                                                                                                                                                                     |
| `renewals[x].new_price`    | `float`    | Precio por día del nuevo periodo, o en una negativa el precio del anfitrión que fue rechazado; ausente cuando no se pudo calcular ningún precio                                                                                            |
| `renewals[x].cap`          | `float`    | Tu límite de precio por día cuando se tomó la decisión                                                                                                                                                                                     |
| `renewals[x].term_seconds` | `int`      | Duración del nuevo periodo en segundos; `0` en una negativa                                                                                                                                                                                |
| `renewals[x].term_start`   | `int`      | Tiempo UNIX en que comienza el nuevo periodo (el final del anterior); en una negativa, el inicio del periodo que terminó                                                                                                                   |
| `renewals[x].term_end`     | `int`      | Tiempo UNIX en que termina el nuevo periodo; en una negativa, el final del periodo que terminó                                                                                                                                             |

**Ejemplo**

**Entrada:**

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

**Salida:**

En este ejemplo la orden se renovó una vez a 24 por día, dentro de su límite de 30. Al final de ese periodo el precio del anfitrión era 36, por encima del límite, así que la renovación fue rechazada y la orden terminó con ese periodo.

```
{
  "renewals": [
    {
      "order_id": 12345,
      "renewal_no": 2,
      "outcome": "rechazada",
      "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-es/para-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.
