Tutoriales

Creando y configurando un bot de trading

 

Aprende a crear un bot de trading con la API de Cryptohopper y edita la configuración de tus bot(s) de trading. En 2 sencillos pasos, crearemos un nuevo bot de trading y añadiremos ajustes de configuración al bot de trading recién creado.

Para realizar peticiones a la API necesitarás crear una app y tener un token de acceso. Si aún no has creado un token de acceso, sigue primero el tutorial Get an access token with Oauth2.

Paso 1: Crear un nuevo bot de trading

Para crear un nuevo bot de trading con la API, deberás realizar una llamada POST al endpoint de hopper. Con la llamada POST, puedes enviar valores de configuración inmediatamente, pero en este ejemplo, solo enviaremos algunos ejemplos de configuración y configuraremos el bot de trading en el siguiente paso. Abajo, encontrarás el endpoint de la API y el JSON que deberás enviar con la petición POST.

Endpoint de la API:

https://api.cryptohopper.com/v1/hopper

JSON POST:

{
    "name": "El nombre de tu bot de trading recién creado.",
    "enabled": 0
}

Cuando la petición a la API sea exitosa, recibirás una respuesta JSON con el valor: id. Este id es el identificador único de tu bot de trading recién creado. Guarda el id, porque lo necesitaremos en el siguiente paso para ajustar la configuración del bot de trading.

Paso 2: Configura tu bot de trading

Ahora que hemos creado un nuevo bot de trading y tienes el id del bot de trading recién creado, es hora de configurar el bot de trading para que puedas empezar a operar automáticamente con él. Todas las actualizaciones de tu bot de trading se realizarán accediendo a los endpoints del bot con tu id, como /hopper/{id}. Para actualizar la configuración de tu bot de trading, deberás realizar una petición PATCH a este endpoint. Abajo, encontrarás el endpoint al cual deberás enviar tu petición PATCH. Por favor, reemplaza {id} con el id que recibiste en el paso 1.

Endpoint de la API:

https://api.cryptohopper.com/v1/hopper/{id}

Necesitarás enviar datos JSON de las actualizaciones que deseas realizar. Si deseas cambiar el nombre de tu bot de trading, por ejemplo, deberás volver a enviar la clave del nombre. Si no deseas cambiar el nombre, simplemente omite este campo. Abajo, encontrarás un ejemplo de una petición JSON PATCH.

Ejemplo de petición JSON PATCH:

{
    "name": "Un nuevo nombre para tu bot de trading recién creado.",
    "enabled": 0,
    "api_config": {
    "api_key": "La clave API de tu cuenta de exchange.",
    "api_secret": "El secreto API de tu cuenta de exchange."
    },
    "config": {
    "exchange": "binance",
        "collect_currency": "btc",
        .... Y más opciones de configuración
    }
}

Revisemos algunas de las posibles opciones de configuración en la petición JSON.

api_config
api_key Esta es la clave API que creaste en tu exchange.
api_secret Este es el secreto API que creaste en tu exchange.
config
exchange Introduce la clave de exchange del exchange que quieres conectar. Para obtener una lista de todos los exchanges y claves, dirígete a: https://api.cryptohopper.com/v1/exchange
collect_currency Esta es la divisa de cotización de tu bot de trading en minúsculas, por ejemplo: btc, usd, eth.
allowed_coins Una lista de arrays de monedas (en mayúsculas) que el bot de trading puede comprar automáticamente. Por ejemplo: ["BTC", "LTC", "ETH"].
perc_buy_amount El porcentaje de tus activos totales que se utilizará para determinar la cantidad de compra.
min_buy_amount La cantidad mínima de compra de las compras automáticas.
max_amount_allocated La cantidad máxima (en divisa de cotización) asignada a tu bot de trading.
strategy La estrategia que deseas configurar. Por ejemplo: no_strategy, multiple_ta. Si deseas configurar una estrategia personalizada, necesitarás el id de la estrategia y configurarla como: user_{id}, por ejemplo: user_1.
num_targets_per_buy El número de objetivos que se comprarán si tu estrategia encuentra varios objetivos.
max_open_time_buy El número de minutos que las órdenes de compra pueden permanecer abiertas antes de que se cancelen automáticamente.
max_open_time El número de minutos que las órdenes de venta pueden permanecer abiertas antes de que se cancelen automáticamente.
set_percentage El porcentaje de obtención de beneficios que deseas configurar, por ejemplo: 1.5.

Por supuesto, hay muchas otras opciones de configuración. Echa un vistazo a la referencia de la API para obtener más información sobre el objeto config.

Cuando hayas actualizado correctamente la configuración de tu bot de trading, recibirás una respuesta 200 con tu objeto config completo devuelto. Si la petición falla, recibirás un estado 400 con un mensaje de error que explica el error.

Esperamos que hayas conseguido crear y configurar tu bot de trading después de leer este tutorial. Ahora podrás ajustar la configuración de tu bot de trading y añadir nuevos bots de trading a tu cuenta.