Skip to main content
InicioIntegracionesWebhook → Bybit
Guía de integración de webhook personalizado a Bybit

Webhook a Bybit — automatiza órdenes de cripto desde tu propio código

Para enviar un webhook a Bybit, haz POST de un payload JSON plano a tu URL de webhook única de PipSync: PipSync valida el token secreto, mapea los campos a una orden de derivados de Bybit y la coloca en tu Unified Trading Account 24/7 — usando una API key solo de trading con los retiros deshabilitados, de modo que tu código nunca toca tus claves privadas directamente.

Empieza gratis — sin tarjetaVer precios

Advertencia de riesgo: Los CFD son instrumentos complejos y conllevan un alto riesgo de perder dinero rápidamente debido al apalancamiento. El 70–80% de las cuentas de inversores minoristas pierden dinero al operar con CFD. Advertencia de riesgo · Rentabilidad pasada.

Esta ruta es agnóstica al origen: cualquier sistema que pueda hacer un POST por HTTPS — un script de Python, un bot de backtesting, una función serverless o una automatización no-code — puede operar Bybit a través del mismo contrato JSON. PipSync ejecuta la capa de ejecución en la nube con controles de riesgo del lado del servidor, cierres reduce-only y webhooks salientes firmados para el feedback, así que conservas tu propia lógica de estrategia mientras delegas el enrutamiento de órdenes, los reintentos y la seguridad de la cuenta.

Webhook a Bybit de un vistazo

OrigenCualquier sistema que pueda hacer POST de JSON plano por HTTPS (scripts, bots, serverless, no-code)
DestinoDerivados de cripto de Bybit (perpetuos USDT/USDC) en la Unified Trading Account
PayloadJSON plano: action, symbol, price/sl/tp/lots/comment opcionales; action "close" cierra la posición
API keyTu propia key de Bybit solo de trading, con retiros deshabilitados; nunca se usa para transferencias
Seguridad de órdenesCierres reduce-only más dimensionamiento del lado del servidor, mapeo de SL/TP y límites de operaciones abiertas
FeedbackWebhooks salientes firmados (HMAC-SHA256) más API de lectura REST; límite de tasa entrante por minuto, 429 devuelve Retry-After
PrecioPlan gratuito disponible (0 €); planes de pago desde 49 €/mes

¿Cómo conecto un webhook a Bybit?

Conecta tu propio código o automatización a Bybit a través de PipSync en unos diez minutos. Tú aportas una API key solo de trading; PipSync te da una URL de webhook con token y se encarga de la ejecución.

  1. Crea una cuenta gratuita de PipSync

    Regístrate en app.pipsync.io. El plan Free cuesta 0 € y no requiere tarjeta de crédito, así que puedes construir y probar la integración antes de pagar.

  2. Crea una API key de Bybit solo de trading

    En Bybit, genera una API key con alcance de trading en tu Unified Trading Account y con los retiros deshabilitados. Pega la key y el secret en PipSync; se almacenan del lado del servidor y nunca se devuelven a tu código.

  3. Añade un origen de webhook personalizado

    En PipSync, crea un origen de webhook JSON personalizado. PipSync emite una URL única cuyo token secreto es la credencial — mantenla privada y rótala desde el panel si alguna vez se filtra.

  4. Configura reglas de riesgo del lado del servidor

    Define dimensionamiento por lote fijo o por porcentaje de riesgo, mapeo de SL/TP, filtros de símbolos y máximo de operaciones abiertas. Estas reglas se ejecutan antes de que cualquier orden llegue a Bybit, así que los mismos límites aplican incluso cuando tu máquina está apagada.

  5. Haz POST de tu primer payload JSON

    Desde tu script o automatización, envía un cuerpo JSON plano con action, symbol y los opcionales price, sl, tp, lots y comment a la URL del webhook. Usa el nombre exacto del símbolo en Bybit; usa action "close" para cerrar una posición abierta.

  6. Verifica en Modo de prueba y luego pasa a producción

    Activa el Modo de prueba para confirmar que PipSync interpreta tus payloads correctamente sin ejecutar, luego desactívalo y ejecuta una orden real pequeña para confirmar las ejecuciones de extremo a extremo antes de escalar.

Tiempo de configuración típico: unos 11 minutos.

¿Cómo se ve el payload JSON para un webhook de Bybit?

El payload es un único objeto JSON plano — sin anidamiento — que se mapea directamente a una orden de derivados de Bybit. El campo central es action ("buy", "sell" o "close"), seguido de symbol, que debe coincidir con el nombre exacto del contrato en Bybit. Los campos opcionales te permiten controlar el precio y el riesgo con precisión.

Los precios son valores absolutos, y un 0 significa "omitir" — pon price en 0 para una orden a mercado, o sl y tp en 0 para dejarlos fuera. El campo lots anula el dimensionamiento que configuraste para esa única operación, así que omítelo cuando quieras que se aplique el dimensionamiento del lado del servidor de PipSync.

  • action: "buy", "sell" o "close" (close cierra la posición abierta en ese símbolo)
  • symbol: el nombre exacto del contrato en Bybit (por ejemplo, un perpetuo USDT)
  • price: precio de entrada absoluto, o 0 para una orden a mercado
  • sl / tp: precios absolutos de Stop-Loss y Take-Profit, o 0 para omitirlos
  • lots: tamaño opcional que anula el dimensionamiento configurado; omítelo para usar el dimensionamiento del lado del servidor
  • comment: etiqueta de texto libre opcional que acompaña a la orden

¿Por qué usar una API key solo de trading para Bybit?

Una API key solo de trading permite a PipSync colocar y gestionar órdenes en tu Unified Trading Account sin poder nunca sacar fondos del exchange. Creas la key en Bybit con los retiros deshabilitados, de modo que aunque la credencial quedara expuesta no podría iniciar una transferencia.

Tu propio código tampoco tiene que incrustar claves de Bybit — haces POST a una URL de webhook de PipSync cuyo token secreto es la única credencial que tienen tus scripts. PipSync almacena la key del exchange del lado del servidor, separando tu código de estrategia del acceso a tu cuenta.

¿Cómo cierra o reduce PipSync una posición en Bybit?

Enviar action "close" en tu payload cierra la posición abierta en ese símbolo. PipSync envía el cierre como una orden reduce-only, así que solo puede reducir o cerrar una posición existente y no abrirá por accidente una nueva en la dirección opuesta.

Esto importa en la Unified Trading Account, donde el margen unificado y los perpetuos hacen que la exposición se invierta con facilidad. Los cierres reduce-only te dan una forma determinista de salir desde tu código sin tener que dudar si una ejecución revirtió tu posición.

¿Cómo obtengo feedback de ejecución de las operaciones en Bybit?

PipSync te ofrece tres canales de feedback para que tu sistema siempre sepa qué pasó. Los webhooks salientes firmados se disparan en los eventos trade.opened, trade.closed, tp_hit y sl_hit, cada uno con una firma HMAC-SHA256 en la cabecera X-PipSync-Signature y reintentados hasta cinco veces con backoff. Una API de lectura REST (GET /v1/signals y GET /v1/trades, documentada mediante OpenAPI 3.1) te permite consultar el estado a demanda, y el panel muestra cada señal interpretada y cada orden en todos los planes.

Los webhooks entrantes tienen límite de tasa por minuto, que escala según el plan desde el nivel de entrada hasta límites personalizados en Enterprise. Si superas el límite recibes un 429 con una cabecera Retry-After — aplica backoff con jitter y tus ráfagas se estabilizarán con limpieza. La API de lectura forma parte del plan Enterprise.

¿La ruta de Bybit funciona 24/7 sin un servidor propio?

Sí. La ruta de Bybit de PipSync está totalmente basada en la nube y funciona 24/7, lo que encaja con los mercados de cripto que nunca cierran. No hay VPS, ni plugin, ni terminal que mantener abierto — una vez configurados tu origen de webhook y tu key solo de trading, la ejecución continúa esté tu portátil encendido o apagado.

Como la ruta es agnóstica al origen, la misma configuración funciona para un script ejecutado por cron, un bot alojado o una función basada en eventos. Tu trabajo es hacer POST de JSON válido; PipSync se encarga de la autenticación, el enrutamiento de órdenes, los reintentos y las comprobaciones de riesgo del lado del servidor.

Pruébalo con el plan gratuito

Conecta una fuente de señales y una cuenta de bróker, observa cómo PipSync analiza y enruta en tiempo real, y mejora tu plan solo si necesitas más. Sin tarjeta de crédito para empezar.

Empieza gratis — sin tarjetaVer precios

Advertencia de riesgo: Los CFD son instrumentos complejos y conllevan un alto riesgo de perder dinero rápidamente debido al apalancamiento. El 70–80% de las cuentas de inversores minoristas pierden dinero al operar con CFD. Advertencia de riesgo · Rentabilidad pasada.

FAQ

Preguntas frecuentes

¿Cuál es la diferencia entre un webhook a Bybit y usar la API de Bybit directamente?

Llamar a la API de Bybit directamente significa que tu propio código gestiona la autenticación, la firma, los reintentos, los límites de tasa y el manejo de errores. Un webhook a Bybit a través de PipSync te permite hacer POST de un payload JSON plano sencillo mientras PipSync gestiona la conexión con el exchange, aplica controles de riesgo del lado del servidor y envía eventos de feedback firmados. Tus scripts solo tienen un token de webhook, no tus claves de Bybit.

Escrito por el equipo de PipSync · Revisado por Tobias Russmann, Director, PipSync · Publicado · Última actualización

PipSync es una plataforma de automatización de señales basada en la nube que enruta señales de trading desde Telegram, Discord, alertas de TradingView y webhooks personalizados a cuentas de bróker en MetaTrader 4, MetaTrader 5, cTrader, Match-Trader, Binance Futures y Bybit, con gestión de riesgo del lado del servidor y sin necesidad de VPS. PipSync es una herramienta de ejecución, no un proveedor de señales ni asesoramiento de inversión.

PipSync es una herramienta de ejecución de señales. No proporciona señales de trading, no garantiza ningún resultado y no constituye asesoramiento de inversión. Operar productos apalancados conlleva un riesgo sustancial de pérdida. Consulta la advertencia de riesgo y el descargo de rendimiento.