Bybit guarda un historial largo: su API llega unos dos años atrás. Eso hace de Bybit la conexión con más historial desde el primer día. Creas una clave de solo lectura una vez, la pegas en SetupBook, y tus operaciones de perpetuos USDT y spot llegan solas. Lleva unos cinco minutos.
Esta guía muestra cada paso con imágenes. Para saber cómo se conectan todas las plataformas, lee el resumen de todas las conexiones. Si también operas en Binance, mira la guía de Binance.
Antes de empezar
- Una cuenta de SetupBook con Pro. Conectar una plataforma es parte de Pro, y cada diario empieza con 14 días de Pro: empieza 14 días gratis.
- Una cuenta de Bybit. Crea la clave en la web de Bybit; el centro de ayuda de Bybit dice que las claves no se pueden crear en la app.
- Cinco minutos.
La clave solo lee. Eliges Read-Only y dejas desactivados todos los permisos de operar, de órdenes y de transferencias. SetupBook nunca coloca una orden y nunca mueve dinero. Guarda la clave sellada en el servidor y la usa para leer tus ejecuciones.
1. Abre API Management y crea una clave
En la web de Bybit haz clic en el icono de tu cuenta, arriba a la derecha, elige API, abre API Management y pulsa Create New Key. Elige System-generated API Keys: Bybit crea la clave y el secreto por ti, y esas son las dos cosas que pide SetupBook. Ponle a la clave un nombre que reconozcas, por ejemplo SetupBook.
2. Elige Read-Only
En los permisos elige Read-Only. No marques ningún permiso que opere, coloque órdenes o mueva fondos. Una clave de solo lectura es todo lo que necesita un diario.
Restricción de IP: déjala desactivada. Todavía no podemos darte una dirección fija que permitir. Si quieres una, pídenosla en el formulario de comentarios bajo las conexiones. Con una clave de solo lectura no se puede operar ni retirar nada, con o sin restricción. Una cosa que conviene saber: Bybit desactiva una clave sin restricción de IP a los 90 días. Cuando pase, crea una clave nueva y usa Reemplazar la clave (mira más abajo).
3. Copia la clave API y el secreto
Confirma con tu verificación de seguridad. Bybit muestra la API key y el secreto. Copia las dos en un lugar seguro, como un gestor de contraseñas, enseguida. Los exchanges suelen mostrar el secreto una sola vez, así que si lo pierdes, crea una clave nueva.
4. Pégalas en SetupBook
En SetupBook abre Cuentas → Conexiones y pulsa Añadir conexión. Elige Bybit, deja Entorno en Real, pega la clave en Clave API y el secreto en Secreto API.
En Mercados marca lo que operas: Perpetuos USDT y Spot. Bybit no necesita lista de pares: SetupBook encuentra los símbolos a partir de tus ejecuciones. Deja En la cuenta en Crear desde la cuenta de la plataforma, o elige una de tus cuentas, y pulsa Comprobar la clave y conectar.
SetupBook comprueba antes la clave con Bybit. Si la clave puede hacer más que leer, te avisa; elimina esa clave en Bybit y crea una de solo lectura.
5. Mira la primera sincronización
La primera sincronización empieza al momento y trae todo lo que Bybit aún sirve, unos dos años. Cuando termina, la conexión muestra Activa, la hora de la última sincronización y el número de operaciones. Después SetupBook busca ejecuciones nuevas cada hora, y puedes pulsar Sincronizar en cualquier momento.
Qué obtienes:
- Posiciones, no ejecuciones sueltas. Las ejecuciones se agrupan en posiciones igual que en la importación de archivos, así que una posición cerrada en tres partes es una operación con tres salidas.
- Campos bloqueados. Símbolo, lado, horas, precios, tamaño, comisiones y el resultado neto vienen de Bybit y se mantienen exactos (alimentan tu beneficio neto). El plan, la calidad del setup, los errores, las notas y las capturas siguen siendo tuyos.
- Zona horaria. Las horas de Bybit están en UTC, así que no hay nada que configurar.
- No incluido. Los contratos margen en moneda (inversos) y los pagos de funding no se leen.
Demo Trading
Bybit Demo Trading es una cuenta propia con su propio ID de usuario. En Bybit cambia a Demo Trading, pasa el cursor sobre tu avatar, abre API allí y crea una clave. En SetupBook elige Demo en el campo Entorno y pega esa clave. Sus operaciones aterrizan en una cuenta Demo. No uses el sitio aparte de testnet de Bybit: es otra cosa. Bybit guarda las órdenes demo solo 7 días, así que conecta pronto si quieres conservarlas.
Reemplazar una clave
Abre el menú de la conexión, elige Editar y pulsa Reemplazar la clave. Pega la clave y el secreto nuevos y guarda: SetupBook los comprueba, olvida los antiguos y usa los nuevos desde la siguiente sincronización. Las operaciones se quedan.
Problemas
¿Problemas para conectar? Escríbenos desde la página de conexiones con lo que has probado. Respondemos por correo en 30 minutos, todos los días.
Preguntas frecuentes
¿Es seguro? ¿Puede SetupBook operar o retirar?
No. Una clave Read-Only no puede colocar una orden ni retirar, y SetupBook no tiene código que lo intente. La clave se guarda sellada en el servidor y nunca se envía a tu navegador. Si quieres parar, elimina la clave en Bybit y la conexión simplemente se detiene.
¿Tengo que restringir la dirección IP?
No. Deja la restricción de IP desactivada. Todavía no podemos darte una dirección fija que permitir; si quieres una, pídenosla en el formulario de comentarios. Una clave de solo lectura no puede operar ni retirar, con o sin regla de IP.
¿Hasta cuándo llegan mis operaciones?
Unos dos años en la primera sincronización. Si tu historial es más antiguo, tiene que entrar como archivo: si puedes exportarlo desde Bybit como CSV, la opción Otro CSV de la importación asigna sus columnas (mira la guía de importación).
¿Qué mercados de Bybit se leen?
Perpetuos USDT y spot. Los contratos de margen en moneda y los pagos de funding aún no se leen.
¿Cuesta algo?
Conectar es parte de Pro. Cada diario empieza con 14 días de Pro y no se cobra nada en esos 14 días. Si cancelas antes de que terminen, te quedas en el plan gratuito, que mantiene el registro manual.
¿Prefieres un archivo? La importación sigue funcionando: mira la guía de uso. Para conectar otro exchange, lee la guía de OKX.