Cómo instalar API para JavaScript - www.microcontrolador.net

Paso 1: Verificar si tienes Node.js instalado

Antes de comenzar, asegúrate de tener Node.js instalado en tu sistema. Puedes verificarlo ejecutando:

node -v
npm -v

node -v: Muestra la versión de Node.js.
npm -v: Muestra la versión de npm (el administrador de paquetes de Node.js).

Si no están instalados, sigue estos pasos:

Instalar Node.js

En sistemas basados en Linux o macOS, puedes usar los siguientes comandos:

Para Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Para macOS (usando Homebrew):

brew install node

Para Windows:

Descarga e instala el instalador desde la página oficial de Node.js y sigue las instrucciones.

Paso 2: Crear un proyecto Node.js

Crea un directorio para tu proyecto y inicializa un nuevo proyecto Node.js:

mkdir bybit-trading-bot
cd bybit-trading-bot
npm init -y

mkdir bybit-trading-bot: Crea un directorio para tu bot.
cd bybit-trading-bot: Ingresa al directorio.
npm init -y: Inicializa un nuevo proyecto Node.js con valores predeterminados.

Esto generará un archivo package.json en el directorio del proyecto.

Paso 3: Instalar la biblioteca de la API de Bybit

Existen varias bibliotecas de terceros que facilitan la interacción con la API de Bybit en JavaScript. Una de las más populares es bybit-api . Puedes instalarla usando npm:

npm install bybit-api

si queremos permitir solicitudes HTTP

npm install bybit-api axios

Este comando instalará la biblioteca en tu proyecto y la agregará como dependencia en package.json.

Paso 4: Instalar otras dependencias útiles

Dependiendo de tus necesidades, podrías necesitar otras bibliotecas. Aquí hay algunas recomendadas:

axios : Para realizar solicitudes HTTP.
dotenv : Para manejar variables de entorno (como tus claves API).
moment o date-fns : Para trabajar con fechas y horarios.

Instálalas con:

npm install axios dotenv moment

Paso 5: Configurar tus claves API

Para interactuar con la API de Bybit, necesitarás tus claves API (API_KEY y SECRET_KEY). Guarda estas claves en un archivo .env para mantenerlas seguras.

Crea un archivo .env en la raíz de tu proyecto:

touch .env

2. Abre el archivo .env y agrega tus claves:

API_KEY=TU_API_KEY_AQUI
SECRET_KEY=TU_SECRET_KEY_AQUI

3. En tu código JavaScript, usa la biblioteca dotenv para cargar estas variables:

require('dotenv').config();
const API_KEY = process.env.API_KEY;
const SECRET_KEY = process.env.SECRET_KEY;

Paso 6: Escribir código básico para conectarte a la API

A continuación, te muestro un ejemplo básico de cómo usar la biblioteca bybit-api para conectarte y obtener información:

Código de ejemplo:

Crea un archivo index.js en la raíz de tu proyecto:

touch index.js

Luego, abre el archivo y pega el siguiente código:

// Importar las bibliotecas necesarias
const Bybit = require('bybit-api');
require('dotenv').config();

// Configurar las claves API
const API_KEY = process.env.API_KEY;
const SECRET_KEY = process.env.SECRET_KEY;

// Inicializar el cliente Bybit
const client = new Bybit({
    apiKey: API_KEY,
    apiSecret: SECRET_KEY,
    testnet: true // Cambia a false si deseas usar la red principal
});

// Función para obtener el saldo de la cuenta
async function getBalance() {
    try {
        const balance = await client.getWalletBalance();
        console.log("Saldo:", balance);
    } catch (error) {
        console.error("Error al obtener el saldo:", error);
    }
}

// Función para obtener las velas históricas
async function getKlines(symbol, interval, limit) {
    try {
        const klines = await client.getKlineList({
            symbol: symbol,
            interval: interval,
            limit: limit
        });
        console.log("Velas históricas:", klines);
    } catch (error) {
        console.error("Error al obtener las velas:", error);
    }
}

// Ejecutar las funciones
getBalance();
getKlines('BTCUSDT', '1m', 10); // Obtener 10 velas de BTCUSDT con intervalo de 1 minuto

Paso 7: Ejecutar el programa

Para ejecutar el programa, usa el siguiente comando:

node index.js

Si todo está configurado correctamente, deberías ver el saldo de tu cuenta y las velas históricas en la consola.

Explicación del Código

Importar bibliotecas :
- bybit-api: Permite interactuar con la API de Bybit.
- dotenv: Carga las variables de entorno desde el archivo .env.
Configurar claves API :
- Las claves se cargan desde el archivo .env para evitar exponerlas en el código.
Inicializar el cliente :
- Se crea una instancia del cliente Bybit con tus claves API.
- El parámetro testnet: true indica que se utilizará el entorno de prueba (testnet). Cambia a false para usar la red principal.
Funciones asincrónicas :
- getBalance: Obtiene el saldo de tu cuenta.
- getKlines: Obtiene las velas históricas para un símbolo específico.
Ejecución :
- Ambas funciones se llaman al final del script.

Paso 8: Manejar errores y excepciones

La API de Bybit puede devolver errores debido a problemas de conexión, límites de tasas o credenciales incorrectas. Asegúrate de manejarlos adecuadamente usando bloques try-catch, como se muestra en el código anterior.

Paso 9: Probar en Testnet

Bybit ofrece un entorno de prueba (testnet) donde puedes probar tus estrategias sin riesgo. Para usarlo:

Genera claves API en el testnet desde la plataforma de Bybit.
Configura testnet: true en el cliente.

Paso 10: Optimizar y expandir

Una vez que tengas una conexión básica funcionando, puedes expandir tu bot para incluir funcionalidades como:

Realizar órdenes de compra/venta.
Calcular indicadores técnicos (SMA, RSI, etc.).
Implementar estrategias de trading automatizado.

Consejos Adicionales

Gestión de Claves :

Nunca expongas tus claves API en código público o repositorios compartidos. Usa siempre archivos .env o variables de entorno.

Logs :
- Implementa un sistema de registro para capturar eventos importantes y facilitar la depuración.
Backtesting :
- Antes de ejecutar estrategias en producción, pruébalas en datos históricos o en el testnet.
Límites de Tasas :
- Bybit tiene límites en el número de solicitudes por segundo. Asegúrate de respetarlos para evitar bloqueos temporales.

Resumen

Verifica que tienes Node.js instalado.
Crea un proyecto Node.js con npm init -y.
Instala la biblioteca bybit-api y otras dependencias útiles.
Guarda tus claves API en un archivo .env y configura el cliente Bybit.
Escribe funciones básicas para interactuar con la API.
Ejecuta el programa con node index.js.
Prueba en el entorno testnet antes de pasar a producción.