Conecta la API de tu exchange

Crea una API key de solo lectura en tu exchange y pégala en Blave para ver tus saldos y posiciones de todos los exchanges en una sola página. Blave no puede operar ni retirar con ella.

Conectar la API de un exchange significa darle a Blave una API key de solo lectura creada en tu exchange, para que Studio pueda leer tus saldos y posiciones. Hay seis exchanges compatibles: Binance, OKX, BingX, Bitget, Bitunix y Bybit. La key solo necesita permiso de lectura: con ella, Blave no puede colocar órdenes ni retirar fondos. Crea la key en tu exchange y pégala en la página de API de Blave.

¿Qué obtienes al conectar?

• Página de Portafolio: todos los exchanges conectados en un solo lugar — evolución del valor de la cuenta, rendimiento, asignación, y el saldo y la exposición de cada moneda por exchange y billetera.
• El selector de símbolos de los gráficos de Studio suma una pestaña "Portafolio" con las monedas que tienes ahora, así cambias de gráfico sin buscar.
• Cuentas que lee Blave: en Binance, spot, futuros USDⓈ-M y Simple Earn flexible; en OKX, la cuenta de trading; en BingX, spot y futuros perpetuos; en Bitget, spot y futuros de la cuenta clásica; en Bitunix, spot y futuros; en Bybit, la Cuenta de Trading Unificada. Ninguno de los seis lee la cuenta Funding: las monedas que tengas ahí no aparecen en la página de Portafolio.

¿Es seguro darle una API key a Blave?

• Otorga solo permiso de lectura. Los exchanges vinculan los permisos a la propia key: quien tenga una key de solo lectura puede ver la cuenta, pero no puede colocar órdenes, transferir ni retirar.
• Blave usa la key para leer tus saldos y posiciones de forma periódica; con eso arma la página de Portafolio.
• El cuadro de conexión incluye la Política de conexión de API: Blave recopila y analiza de forma anonimizada los datos de las cuentas conectadas para mejorar el producto. Si quieres que Blave deje de leer tu cuenta, elimina la key con los pasos de eliminación.

¿Cómo creas una API key de solo lectura en cada exchange?

El flujo es parecido en todos: abre la página de gestión de API de tu cuenta, crea una key, dale solo permiso de lectura, completa la verificación de seguridad y copia la key. Dos reglas valen para todos los exchanges:

• Deja vacía la lista de IP permitidas. Si vinculas tu propia IP, los servidores de Blave no están en la lista y no pueden leer la cuenta.
• Solo lectura. Deja desactivados los permisos de trading, transferencia y retiro.

Binance｜OKX｜BingX｜Bitget｜Bitunix｜Bybit

Los nombres de botones y campos siguen el sitio web en inglés de cada exchange; pueden cambiar en otros idiomas o tras un rediseño.

Binance

Antes de crear una key, Binance exige 2FA activada, un depósito de cualquier monto en tu Billetera Spot y verificación de identidad. Usa una key generada por el sistema (HMAC); las keys RSA/Ed25519 autogeneradas no conectan. Al conectar, Blave comprueba tu cuenta de futuros USDⓈ-M, así que una cuenta sin futuros habilitados no conecta.

1. Inicia sesión en Binance desde la web, haz clic en tu icono de perfil → "Account" → "API Management" y luego en "Create API". En la app: "More" → "Other" → "API Management".
2. Elige "System-generated", escribe Blave como etiqueta y completa la 2FA.
3. Comprueba que "Enable Reading" sea el único permiso (viene por defecto). No marques nada más ni configures restricción de IP.
4. Copia la API Key y la Secret Key.

Guía oficial de Binance

OKX

1. Inicia sesión en OKX desde la web, ve a "Profile" → "API and connections" y haz clic en "Create API key".
2. Escribe un nombre para la API key (por ejemplo, Blave) y en "Account" elige la cuenta que Blave debe leer.
3. En "Permissions", marca solo "Read". Deja vacía la lista de direcciones IP permitidas.
4. Define una Passphrase y anótala. OKX no vuelve a mostrarla: si la pierdes, tendrás que borrar la key y crear otra. La necesitarás al conectar en Blave.
5. Completa la verificación de seguridad y copia la API Key y la Secret Key.

Guía oficial de OKX

BingX

Al conectar, Blave comprueba tu cuenta de futuros perpetuos, así que una cuenta sin futuros habilitados no conecta.

1. Inicia sesión en BingX desde la web, abre "API Management" en tu centro de usuario y haz clic en "Create API".
2. Escribe un nombre que reconozcas (por ejemplo, Blave) y completa la verificación de seguridad.
3. Deja solo el permiso de lectura: desactiva trading spot, trading de futuros, transferencia universal, gestión de subcuentas y retiros, y deja la IP vacía. BingX no elimina las keys de solo lectura por inactividad.
4. Copia la API Key y la Secret Key.

Abrir la gestión de API de BingX

Bitget

Por ahora solo se admiten cuentas clásicas. Una key de una Cuenta de Trading Unificada (UTA) devuelve "Invalid API." al conectar.

1. Inicia sesión en Bitget desde la web, abre "API Management" en tu centro personal y haz clic en "Create New API".
2. Escribe Blave en "Notes" y define una API Passphrase. Anótala: la necesitarás al conectar en Blave.
3. Elige el permiso "Read-only" y no vincules ninguna IP.
4. Introduce los códigos de verificación de correo, SMS y Google, y copia la API Key y la Secret Key.

Guía oficial de Bitget

Bitunix

Al conectar, Blave comprueba tu cuenta de futuros, así que una cuenta sin futuros habilitados no conecta.

1. Inicia sesión en Bitunix, haz clic en tu icono de perfil → "API Management" y luego en "Create API".
2. Escribe Blave en "Note" y elige "Bind Third-Party App" en "Purpose": los permisos pasan a "Read-only" automáticamente. Si la pantalla es distinta, lo importante es dar solo permiso de lectura.
3. Completa la verificación de seguridad. La API Key y la Secret Key aparecen en pantalla: cópialas y guárdalas en ese momento.

Abrir la gestión de API de Bitunix

Bybit

Las cuentas nuevas pueden no poder crear keys durante las primeras 48 horas. Usa una key generada por el sistema (HMAC); las keys RSA/Ed25519 autogeneradas no conectan. Una key de Bybit sin IP vinculada vence a los 90 días: consulta qué hacer si falla la conexión para extenderla.

1. Abre la web de Bybit en una computadora (las API keys no se pueden crear en la app) y haz clic en tu icono de perfil → "API" para entrar en la página "API Management".
2. Haz clic en "Create New Key" y elige "System-generated API Keys".
3. Elige el uso que ofrezca la pantalla y escribe Blave como nombre.
4. Elige el permiso "Read-Only" y la opción "No IP restriction".
5. Introduce tu código de Google 2FA y copia la API Key y la Secret Key.

Guía oficial de Bybit

Pega la key en Blave

¿Qué hacer si falla la conexión?

• Aparece "Invalid API.": Blave no pudo leer la cuenta con esta key. Revisa en orden: la key se copió incompleta o con espacios de más; el exchange elegido no es el correcto; falta la Passphrase de OKX o Bitget, o es incorrecta; la key de Binance o Bybit es RSA/Ed25519 autogenerada; los futuros no están habilitados en Binance, BingX o Bitunix.
• Una key de Bitget siempre devuelve "Invalid API.": si tu cuenta de Bitget es una Cuenta de Trading Unificada (UTA), todavía no se puede conectar; Blave solo admite cuentas clásicas.
• Aparece "The API has already been connected.": esta cuenta del exchange ya está conectada a una cuenta de Blave, quizá otra tuya. Elimínala primero en la página de API de esa cuenta y vuelve a conectar.
• Bybit funcionaba y dejó de traer datos: las keys de Bybit sin IP vinculada vencen a los 90 días. En la página API Management de Bybit, haz clic en editar en la columna "IP Address Added" de la key, elige "No IP restriction", envía y verifica. La key sigue siendo la misma y suma otros 90 días desde ese momento (FAQ oficial de Bybit).

¿Cómo eliminas una key?

1. Primero, en la pestaña "Exchange" de la página de API de Blave, haz clic en "Eliminar" junto a la key y confirma.
2. Después elimina la misma key en la página de gestión de API de tu exchange.

Respeta este orden. Si eliminas la key primero en el exchange, el registro en Blave no se borra automáticamente.