_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–1,000); los valores fuera de rango se ajustan al límite más cercano.
**Salida**
| Campo | Tipo | Descripción |
| ------ | -------- | ---------------- |
| `code` | `entero` | 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 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` | `entero` | Sí | ID de oferta único |
| `desired_price` | `flotante` | Sí | Tu precio ofrecido por día |
> **Un precio por debajo del suelo 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 en un máximo de 0.00000100 ₿
| Campo | Tipo | Descripción |
| ---------- | ---------- | -------------------------------------------------------------- |
| `code` | `entero` | Código de estado |
| `error` | `cadena` | Campo de descripción del error |
| `max_step` | `flotante` | Valor mínimo hasta el que puedes rebajar el precio actualmente |
```
{
"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` | `entero` | Código de estado |
| `error` | `cadena` | Campo de descripción del error |
| `time_to_lowering` | `flotante` | 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`
**Acerca de**
Cancela una orden activa 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` | `entero` | Sí | ID único de la orden/oferta |
| `issue` | `cadena` | No | Si has encontrado algún problema con el servidor, puedes reportarlo al [clore.ai](http://clore.ai/) equipo, máximo 2048 caracteres |
**Salida**
| Campo | Tipo | Descripción |
| ------ | -------- | ---------------- |
| `code` | `entero` | Código de estado |
**Ejemplo**
Cancelar orden/oferta
**Entrada:**\
En este ejemplo estamos reportando 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` | `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 |
| `image` | `cadena` | Sí | Imagen válida de dockerhub |
| `renting_server` | `entero` | Sí | ID del servidor que deseas alquilar |
| `tipo` | `cadena` | Sí | `bajo demanda` O `spot` |
| `spotprice` | `flotante` | Depende | Precio ofrecido por día en el mercado spot, requerido al hacer una orden spot |
| `ports` | `objeto` | No | Configuración de reenvío de puertos, máximo 5 registros |
| `env` | `objeto` | No | Variables de entorno, limitadas a 12288 caracteres en total al serializarse.
Nombre de variable: máximo 128 símbolos, no debe contener -
Valor de variable: máximo 1536 símbolos
Solo se conservan las primeras 30 variables válidas; las adicionales se descartan silenciosamente
|
| `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 la orden |
| `required_price` | `flotante` | 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` | `entero` | No | Número de GPU que se alquilarán en servidores que admiten [alquiler parcial](/clore.ai/clore.ai-eng-es/para-arrendatarios/partial-gpu-rental.md). Omitir para alquilar el equipo completo. Solo bajo demanda, solo equipos homogéneos |
| `gpu_indices` | `[]int` | No | Índices de ranuras GPU basados en 0 para alquilar; la longitud debe ser igual a `gpu_count`. Toma las ranuras libres de `partial_gpu_rental.free_indices`. Omitir para que el backend elija las GPU libres automáticamente |
| `autossh_entrypoint` | `bool` | No | Usa el punto de entrada de clore.ai, que despliega automáticamente el servidor SSH y el script personalizado `/root/onstart.sh` script |
\* 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` | `entero` | Código de estado |
> **Las ofertas spot por debajo del suelo del servidor** se rechazan con el mínimo actual incluido, así que puedes reintentar inmediatamente:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> El suelo se recalcula a partir de las cotizaciones en vivo aproximadamente cada 10 minutos, por lo que un precio leído en el listado del marketplace puede estar algo desactualizado — usa siempre el `min_price` devuelto para el reintento.
**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 arrendatario, ajustes de reducción de comisión por PoH, comisiones por 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` | `entero` | 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` | `entero` | Reducción máxima de la comisión base mediante PoH (%) |
| `poh_config.max_poh_amount` | `entero` | Saldo PoH en el que se alcanza la reducción máxima |
| `creation_fees.on_demand` | `objeto` | Comisión de creación de orden por moneda |
| `creation_fees.spot` | `objeto` | Comisión de creación de orden spot por moneda |
| `poh_balance` | `flotante` | 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` | `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 a cancelar, máximo 256 |
**Salida**
| Campo | Tipo | Descripción |
| ------------------ | -------- | ------------------------------------------ |
| `code` | `entero` | 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 Prueba de Tenencia: elementos, totales y montos de ofertas del Marketplace PoH
**Encabezados**
| Campo | Tipo | Obligatorio | Descripción |
| ------ | -------- | ----------- | ------------ |
| `auth` | `cadena` | Sí | token de API |
**Salida**
| Campo | Tipo | Descripción |
| --------------------------------------------- | ---------- | ----------------------------------------- |
| `code` | `entero` | Código de estado |
| `items` | `[]objeto` | Tus elementos PoH con saldos individuales |
| `balance.total` | `flotante` | Saldo total de PoH en todos los elementos |
| `balance.free_amount` | `flotante` | Saldo PoH no comprometido en ofertas |
| `balance.reward_amount` | `flotante` | Saldo elegible para recompensas |
| `balance.offers.rented_amount` | `flotante` | Cantidad alquilada a otros usuarios |
| `balance.offers.rented_on_marketplace_amount` | `flotante` | Cantidad listada en el Marketplace PoH |
| `balance.offers.leased_amount` | `flotante` | 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 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`
**Acerca de**
Obtén nodos de relé de reenvío TCP para tu país detectado. No se requiere autenticación
**Salida**
| Campo | Tipo | Descripción |
| --------- | -------- | ------------------------- |
| `code` | `entero` | Código de estado |
| `country` | `cadena` | Código de país detectado |
| `nodes` | `objeto` | Nodos de relé 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.