Bitfinex es una de las plataformas de intercambio de criptomonedas más grandes y avanzadas del mundo. Los usuarios pueden intercambiar Bitcoin, Ethereum, Ripple, EOS, Bitcoin Cash, Iota, NEO, Litecoin, Ethereum Classic...
La versión de la API WebSocket de Bitfinex es 2.0
Cada mensaje enviado y recibido a través del canal WebSocket de Bitfinex está codificado en formato JSON
Un símbolo puede ser un par de trading o una divisa de margen:
Los símbolos de los pares de trading se forman anteponiendo una "t" al par (p. ej., tBTCUSD, tETHUSD).
Los símbolos de las divisas de margen se forman anteponiendo una "f" antes de la divisa (p. ej. fUSD, fBTC, ...)
Tras una conexión exitosa, se activa el evento OnBitfinexConnect y se obtiene el número de versión de la API de Bitfinex como parámetro.
Puede llamar al método Ping para probar la conexión al servidor.
Si el servidor envía alguna información, esta puede gestionarse mediante el evento OnBitfinexInfoMessage, donde un Code y un Message son parámetros con información sobre el mensaje enviado por el servidor. Códigos de ejemplo:
20051: Detener/Reiniciar el servidor WebSocket (por favor, vuelva a conectarse)
20060 : Entrando en modo de mantenimiento. Por favor, pause cualquier actividad y reanúdela tras recibir el mensaje de información 20061 (debería tardar 120 segundos como máximo).
20061: Mantenimiento finalizado. Puede reanudar la actividad normal. Se recomienda cancelar la suscripción y volver a suscribirse a todos los canales.
En caso de error, se activará OnBitfinexError y se proporcionará información sobre el error. Ejemplos de códigos de error:
10000 : Evento desconocido
10001 : Par desconocido
Para cambiar la configuración, llame al método Configuration y pase como parámetro uno de los siguientes indicadores:
CS_DEC_S = 8; // Enable all decimal as strings.
CS_TIME_S = 32; // Enable all times as date strings.
CS_SEQ_ALL = 65536; // Habilitar secuenciación FUNCIÓN BETA
CHECKSUM = 131072; // Habilitar checksum para cada iteración del libro. Verifica las 25 primeras entradas de cada lado del libro. El checksum es un entero con signo.
Hay canales que son públicos y no es necesario autenticarse contra el servidor. Todos los mensajes se generan en el evento OnBitfinexUpdate.
El ticker es una visión general de alto nivel del estado del mercado. Muestra la mejor oferta y demanda actuales, así como el precio de la última operación. También incluye información como el volumen diario y cuánto ha variado el precio durante el último día.
// Trading pairs
[
CHANNEL_ID,
[
BID,
BID_SIZE,
ASK,
ASK_SIZE,
DAILY_CHANGE,
DAILY_CHANGE_PERC,
LAST_PRICE,
VOLUME,
HIGH,
LOW
]
]
// Funding pairs
[
CHANNEL_ID,
[
FRR,
BID,
BID_PERIOD,
BID_SIZE,
ASK,
ASK_PERIOD,
ASK_SIZE,
DAILY_CHANGE,
DAILY_CHANGE_PERC,
LAST_PRICE,
VOLUME,
HIGH,
LOW
]
]
Este canal envía un mensaje de operación cada vez que se produce una transacción en Bitfinex. Incluye todos los detalles relevantes de la operación, como el precio, el tamaño y la hora.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
ID,
MTS,
AMOUNT,
PRICE
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
ID,
MTS,
AMOUNT,
RATE,
PERIOD
],
...
]
]
El canal Order Books le permite realizar un seguimiento del estado del libro de órdenes de Bitfinex. Se proporciona de forma agregada por precio, con precisión personalizable. Tras recibir la respuesta, recibirá una instantánea del libro, seguida de actualizaciones ante cualquier cambio en el mismo.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
PRICE,
COUNT,
AMOUNT
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
RATE,
PERIOD,
COUNT,
AMOUNT
],
...
]
]
Estos son los libros más granulares.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
ORDER_ID,
PRICE,
AMOUNT
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
OFFER_ID,
PERIOD,
RATE,
AMOUNT
],
...
]
]
Proporciona acceso a información de velas para gráficos. Marcos de tiempo disponibles:
1m: un minuto
5m : cinco minutos
15m : 15 minutos
30m : 30 minutos
1h : una hora
3h : 3 horas
6h : 6 horas
12h : 12 horas
1D : un día
7D : una semana
14D : dos semanas
1M : un mes
[
CHANNEL_ID,
[
[
MTS,
OPEN,
CLOSE,
HIGH,
LOW,
VOLUME
],
...
]
]
Este canal le permite mantenerse al día con el estado de su cuenta. Puede recibir actualizaciones sobre sus posiciones, sus saldos, sus órdenes y sus operaciones.
Utilice el método Authenticate para autenticarse en el servidor y establecer los parámetros necesarios.
Una vez autenticado, recibirá actualizaciones de: órdenes, posiciones, operaciones, ofertas de financiación, créditos de financiación, préstamos de financiación, carteras, información de saldo, información de margen, información de financiación, operaciones de financiación...
Puede usar el método UnAuthenticate si desea cerrar sesión en el servidor.