En resumen
Conecta a Arbiq una clave API del exchange de solo lectura y tus ejecuciones se convierten en borradores en el diario de operaciones, mientras que las liquidaciones de funding y de préstamo llegan a las posiciones como importes reales en lugar de una estimación. Se acabó teclear operaciones a mano: en el formulario de la operación marcas las ejecuciones del exchange que la componen, y la cantidad, el precio, la comisión y la hora se rellenan solos.
Compatibles: Bybit, OKX, Gate, Bitget, MEXC, BingX, Binance, KuCoin, Hyperliquid y Aster. Los dos últimos usan un monedero en lugar de una clave; tienen su propia página, Conectar exchanges descentralizados.
Conectar
Abre Cuentas de exchange: el botón está en el diario junto a Nueva posición, y en el menú de la cuenta.
- Crea en el exchange una clave de solo lectura. Si el exchange permite restringir por IP, añade las direcciones que aparecen bajo el formulario. Las claves de OKX y Bitget necesitan una frase de contraseña (passphrase): introdúcela en el formulario.
- Fija la fecha desde la que importar el historial. Piénsala como la fecha de apertura en contabilidad: las ejecuciones y liquidaciones anteriores no se importan. Por defecto es un mes atrás. Se puede cambiar más tarde desde el menú … de la cuenta; la siguiente sincronización vuelve a leer el historial desde la nueva fecha.
- Pulsa Conectar. El producto hace una única petición de lectura: si el exchange la rechaza, ves su respuesta (casi siempre una IP que no está en la lista o una passphrase incorrecta) y la clave no se guarda.
Una cuenta conectada muestra los primeros y últimos caracteres de la clave, lo que el exchange dice que puede hacer (solo lectura u operar; lo segundo no le sirve de nada al diario, mejor sustituye la clave; una clave que puede retirar fondos no se acepta), el inicio del historial y si la clave funciona ahora mismo. Desde … puedes volver a comprobarla, cambiar la fecha o eliminarla. Cómo se guarda la clave: ¿Necesita Arbiq mis claves API del exchange?
Qué permisos dar
El diario solo lee ejecuciones y liquidaciones. Una clave que puede retirar fondos no se acepta en absoluto; una clave que puede operar se conecta, pero queda marcada. Qué marcar en el formulario de la clave del exchange:
| exchange | marca esto | NO marques | passphrase |
|---|---|---|---|
| Bybit | Read-Only, ámbito Unified Trading (Contract + Spot) | Wallet, Withdraw | — |
| OKX | Read only | Trade, Withdraw | sí |
| Gate | Futures “read only”, Spot “read only” | Wallet, Withdraw | — |
| Bitget | Read-only, ámbitos Futures y Spot | Transfer, Withdraw | sí |
| MEXC | Futures → Trade → View Order Details; lo mismo en Spot si lo operas | nada de Account, Withdraw, Transfer | — |
| BingX | solo lectura: Account, Perpetual futures, Spot | trading, Withdraw | — |
| Binance | Enable Reading, Enable Futures | Enable Withdrawals, trading | — |
| KuCoin | General read-only; futuros y spot: lectura | Withdrawal, Transfer | sí |
| Hyperliquid, Aster | un monedero en lugar de una clave, consulta Conectar exchanges descentralizados | — | — |
Dos notas sobre la tabla. En MEXC la clave caduca a los 90 días si no la vinculas a una IP: vincúlala. En Binance las ejecuciones spot se cargan solo para instrumentos que ya están en el diario.
Las mismas indicaciones aparecen en el formulario de conexión bajo el exchange elegido. Si el exchange permite restringir por IP, añade las direcciones del formulario.
Sincronización
El historial se descarga solo cada 15 minutos y también con el botón con el nombre del exchange en la sección Borradores de exchanges. El botón lanza la lectura en segundo plano (una primera conexión con una fecha de inicio lejana puede tardar minutos) y, al terminar, indica cuántos borradores nuevos han llegado.
Cada pasada lee solo lo que apareció desde la anterior, con un pequeño solapamiento. Un registro del exchange nunca se duplica: tiene su propio número y no se carga dos veces. Los borradores que ocultaste tampoco vuelven.
Los exchanges no guardan el historial para siempre: Bybit ofrece unos dos años; OKX, Bitget, MEXC y BingX, unos tres meses. Una fecha de inicio anterior no traerá más datos.
Borradores
Bajo las posiciones abiertas aparece la sección Borradores de exchanges: hora, exchange, símbolo del exchange, lado (compra o venta), cantidad, precio y comisión, en dólares o, si el exchange la cobró en otra moneda, en esa moneda con una nota.
Un borrador espera hasta que montas una operación con él. Uno que no te interesa se puede ocultar: sale de la lista y no vuelve en la siguiente sincronización; Mostrar ocultos vuelve a mostrar la lista, y Recuperar devuelve el borrador en sí.
Una operación a partir de ejecuciones del exchange
En el formulario de la operación (una posición nueva, una entrada o una salida) cada pata muestra los borradores de su exchange e instrumento en la dirección correcta: una entrada compra el long y vende el short; una salida, al revés.
- Marca las ejecuciones que componen la operación. Puedes marcar varias: las cantidades se suman, el precio pasa a ser el ponderado por volumen, las comisiones se suman en dólares y la hora es la de la última ejecución.
- La cantidad, el precio y la comisión se bloquean mientras haya ejecuciones marcadas: son la palabra del exchange. El apalancamiento sigue siendo tuyo: el exchange no lo informa con la ejecución. Desmarca y los campos vuelven a ser tuyos.
- Bajo el campo de precio de cada pata está la cotización en vivo del lado del libro de órdenes en el que opera la operación: el ask para una compra, el bid para una venta. Un clic la pone en el campo, salvo que la pata se haya montado con ejecuciones del exchange.
- Las ejecuciones marcadas quedan vinculadas a la operación: corrige la operación con otro conjunto y las sobrantes vuelven a borradores; elimínala y vuelven todas.
Funding y préstamo
Mientras no haya una clave conectada para el exchange de una pata, el funding de los perpetuos y los intereses horarios del préstamo se estiman a partir de nuestras series de tasas. Con una clave conectada, las liquidaciones del exchange se asignan a la posición por hora y sustituyen por completo la estimación en esa pata: las mismas líneas en el panel de la posición, ahora con los importes del exchange.
Añadir, corregir o eliminar una operación recalcula desde cero el funding y el préstamo de la posición: la ventana de la posición se ha movido, así que las liquidaciones se reparten de nuevo entre las posiciones.
Si algo no va bien
- La cuenta aparece con error: el exchange rechazó una sincronización; su respuesta se ve al pasar el cursor. Normalmente la clave caducó o cambió la lista de IP. Vuelve a comprobarla desde …; tras una sincronización correcta la cuenta vuelve a funcionar.
- No hay borradores aunque hubo operaciones: revisa el inicio del historial; no se carga nada anterior. En Gate y MEXC las ejecuciones spot se leen solo para instrumentos que ya están en el diario.
- Una comisión en otra moneda: el exchange la cobró, por ejemplo, en el activo base; la convertimos a dólares al precio de la ejecución y, cuando no podemos, se queda el importe en la moneda y el campo de comisión del formulario es tuyo.