_spot` valor enviado para ella se ignora. Los `usd_pricing` objetivos son cifras de $/día para todo el servidor validadas contra el rango en USD (0.1–1,000); los valores fuera de rango se ajustan al límite más cercano.
**Salida**
| Campo | Tipo | Descripción |
| ------ | ----- | ---------------- |
| `code` | `int` | Código de estado |
**Ejemplo**
Vamos a crear una prueba de envío para una transacción enviada desde la cartera actual.
**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`
**Acerca de**
Establece el precio por día en tu oferta del mercado SPOT
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth` | `string` | Sí | Token de API |
| `Tipo de contenido` | `string` | 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 con el mínimo actual incluido:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
**Ejemplo**
Intentemos actualizar el precio del mercado spot
**Entrada 1 (la reducción 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 reducción 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` | `string` | Campo de descripción del error |
| `max_step` | `float` | Valor más bajo al que actualmente puedes bajar el precio |
```
{
"error":"exceeded_max_step",
"max_step":0.0000032,
"code":6
}
```
**Entrada 2 (reducción 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 (reducción 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` | `string` | Campo de descripción del error |
| `time_to_lowering` | `float` | Tiempo restante (seg) para la siguiente posibilidad de bajar el precio |
```
{
"error":"can_lower_every_600_seconds",
"time_to_lowering":513,
"code":6
}
```
#### 9. `cancel_order`
**Acerca de**
Cancela una orden activa o una oferta spot
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth` | `string` | Sí | Token de API |
| `Tipo de contenido` | `string` | Sí | Debe ser `application/json` |
**Cuerpo**
| Campo | Tipo | Obligatorio | Descripción |
| ------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `id` | `int` | Sí | ID único de la orden/oferta |
| `issue` | `string` | 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 orden/oferta
**Entrada:**\
En este ejemplo estamos informando de problemas con la GPU #1; si no tienes problemas, no incluyas el campo issue.\
Puedes escribir cualquier mensaje en el campo de texto y lo investigaremos
```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
"id":39,
"issue":"La GPU #1 se estaba sobrecalentando y reduciendo su rendimiento"
}' 'https://api.clore.ai/v1/cancel_order'
```
**Salida:**
```
{
"code": 0
}
```
#### 10. `create_order`
**Acerca de**
Puedes crear una oferta spot o una orden bajo demanda con este endpoint
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth` | `string` | Sí | Token de API |
| `Tipo de contenido` | `string` | Sí | Debe ser `application/json` |
**Cuerpo**
| Campo | Tipo | Obligatorio | Descripción |
| -------------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `string` | Sí | Nombre de la moneda |
| `image` | `string` | Sí | Imagen válida de Docker Hub |
| `renting_server` | `int` | Sí | ID del servidor que quieres alquilar |
| `tipo` | `string` | Sí | `bajo demanda` O `spot` |
| `spotprice` | `float` | Depende | Precio ofrecido por día en el mercado spot, requerido al crear una orden spot |
| `puertos` | `object` | No | Configuración de redirección de puertos, máximo 5 registros |
| `env` | `object` | No | Variables de entorno, limitadas a 12288 caracteres en total al convertirlas a cadena.
Nombre de variable - máximo 128 símbolos, no debe contener -
Valor de la variable - máximo 1536 símbolos
Solo se conservan las primeras 30 variables válidas; las adicionales se descartan silenciosamente
|
| `jupyter_token` | `string` | No | Token de Jupyter para imágenes que tienen notebooks de Jupyter, máximo 32 caracteres \* |
| `ssh_key` | `string` | No | Clave SSH para imágenes con SSH, máximo 3072 caracteres \* |
| `ssh_password` | `string` | No | Contraseña SSH para imágenes con SSH, máximo 32 caracteres \* |
| `command` | `string` | No | El comando se ejecutará en el servidor después de crear la orden |
| `required_price` | `float` | No | Especifica el precio con el que quieres iniciar la orden; si el propietario de la máquina cambia el precio, la orden no se iniciará (solo bajo demanda) |
| `gpu_count` | `int` | No | Número de GPUs a alquilar en servidores que admiten [alquiler parcial](/clore.ai/clore.ai-eng-es/para-arrendatarios/partial-gpu-rental.md). Omite esto para alquilar todo el rig. Solo bajo demanda, solo rigs homogéneos |
| `gpu_indices` | `[]int` | No | Índices de ranuras de GPU a alquilar basados en 0; la longitud debe ser igual a `gpu_count`. Toma las ranuras libres de `partial_gpu_rental.free_indices`. Omite esto para que el backend elija las GPUs libres automáticamente |
| `autossh_entrypoint` | `bool` | No | Usa el entrypoint de clore.ai, que despliega automáticamente un servidor SSH y un `/root/onstart.sh` script |
\* En los campos marcados con asterisco solo puedes introducir caracteres de este grupo regex `/^[a-zA-Z0-9\s-=.@+/]+$/`
**Salida**
| Campo | Tipo | Descripción |
| ------ | ----- | ---------------- |
| `code` | `int` | Código de estado |
> **Las ofertas spot por debajo del mínimo del servidor** se rechazan con el mínimo actual incluido, así que puedes reintentar de inmediato:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> El mínimo se recalcula a partir de los tipos de cambio en vivo aproximadamente cada 10 minutos, por lo que un precio leído en la lista del mercado puede estar ligeramente desactualizado — usa siempre el `min_price` devuelto para reintentar.
**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
}
```
#### 11. `renter_fees`
**Acerca de**
Obtén la configuración actual de comisiones: comisiones base del inquilino, ajustes de reducción de comisión PoH, comisiones de creación de órdenes y tu saldo PoH
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------ | -------- | ----------- | ------------ |
| `auth` | `string` | Sí | Token de API |
**Salida**
| Campo | Tipo | Descripción |
| ---------------------------------- | -------- | ------------------------------------------------------ |
| `code` | `int` | Código de estado |
| `renter_fees.on_demand` | `object` | Comisión base (%) por moneda para órdenes bajo demanda |
| `renter_fees.spot` | `object` | 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 en el que se alcanza la reducción máxima |
| `creation_fees.on_demand` | `object` | Comisión de creación de orden por moneda |
| `creation_fees.spot` | `object` | Comisión de creación de orden 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`
**Acerca de**
Cancela varias órdenes a la vez (hasta 256 por solicitud)
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------------------- | -------- | ----------- | --------------------------- |
| `auth` | `string` | Sí | Token de API |
| `Tipo de contenido` | `string` | Sí | Debe ser `application/json` |
**Cuerpo**
| Campo | Tipo | Obligatorio | Descripción |
| ----------- | ------- | ----------- | ---------------------------------------- |
| `order_ids` | `[]int` | Sí | IDs de órdenes para 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`
**Acerca de**
Obtén tu saldo de Proof of Holding: elementos, totales y montos de ofertas del Marketplace PoH
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------ | -------- | ----------- | ------------ |
| `auth` | `string` | Sí | Token de API |
**Salida**
| Campo | Tipo | Descripción |
| --------------------------------------------- | ---------- | ----------------------------------------- |
| `code` | `int` | Código de estado |
| `elementos` | `[]object` | Tus elementos PoH con saldos individuales |
| `balance.total` | `float` | Saldo PoH total entre 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` | Cantidad alquilada a otros usuarios |
| `balance.offers.rented_on_marketplace_amount` | `float` | Cantidad listada en el Marketplace de PoH |
| `balance.offers.leased_amount` | `float` | Cantidad arrendada 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`
**Acerca de**
Obtén datos de configuración estática de la API. No requiere autenticación
**Entrada:**
```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```
#### 15. `get_relay`
**Acerca de**
Obtén nodos de relay de reenvío TCP para tu país detectado. No requiere autenticación
**Salida**
| Campo | Tipo | Descripción |
| --------- | -------- | -------------------------- |
| `code` | `int` | Código de estado |
| `country` | `string` | Código de país detectado |
| `nodes` | `object` | Nodos de relay disponibles |
**Entrada:**
```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-es/para-hosts/api.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
