Bitfinex est l'une des plus grandes et des plus avancées plateformes de trading de cryptomonnaies au monde. Les utilisateurs peuvent échanger du Bitcoin, Ethereum, Ripple, EOS, Bitcoin Cash, Iota, NEO, Litecoin, Ethereum Classic...
La version de l'API WebSocket Bitfinex est 2.0
Chaque message envoyé et reçu via le canal WebSocket de Bitfinex est encodé au format JSON
Un symbole peut être une paire de trading ou une devise de marge :
Les symboles de paires de trading sont formés en ajoutant un « t » avant la paire (c.-à-d. tBTCUSD, tETHUSD).
Les symboles de devises de marge sont formés en ajoutant un "f" avant la devise (ex. fUSD, fBTC, …)
Après une connexion réussie, l'événement OnBitfinexConnect est déclenché et vous obtenez le numéro de version de l'API Bitfinex en paramètre.
Vous pouvez appeler la méthode Ping pour tester la connexion au serveur.
Si le serveur envoie des informations, celles-ci peuvent être traitées via l'événement OnBitfinexInfoMessage, où un Code et un Message sont des paramètres contenant des informations sur le message envoyé par le serveur. Exemples de codes :
20051 : Arrêt/Redémarrage du serveur WebSocket (veuillez vous reconnecter)
20060 : Entrée en mode de maintenance. Veuillez suspendre toute activité et reprendre après réception du message d'information 20061 (cela devrait prendre 120 secondes au maximum).
20061 : Maintenance terminée. Vous pouvez reprendre l'activité normale. Il est conseillé de se désabonner/réabonner à tous les canaux.
En cas d'erreur, OnBitfinexError sera déclenché et des informations sur l'erreur seront fournies. Exemples de codes d'erreur :
10000 : Événement inconnu
10001 : Paire inconnue
Pour modifier la configuration, appelez la méthode Configuration et passez comme paramètre l'un des indicateurs suivants :
CS_DEC_S = 8; // Activer tous les décimaux en tant que chaînes.
CS_TIME_S = 32; // Enable all times as date strings.
CS_SEQ_ALL = 65536; // Activer le séquençage FONCTIONNALITÉ BÊTA
CHECKSUM = 131072; // Activer la somme de contrôle pour chaque itération de carnet. Vérifie les 25 premières entrées de chaque côté du carnet. La somme de contrôle est un entier signé.
Il existe des canaux qui sont publics et pour lesquels il n'est pas nécessaire de s'authentifier auprès du serveur. Tous les messages sont déclenchés dans l'événement OnBitfinexUpdate.
Le ticker est une vue d'ensemble de haut niveau de l'état du marché. Il vous montre la meilleure offre et demande actuelles, ainsi que le dernier prix de transaction. Il comprend également des informations telles que le volume quotidien et l'évolution du prix au cours de la dernière journée.
// 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
]
]
Ce canal envoie un message de trade chaque fois qu'un trade se produit sur Bitfinex. Il inclut tous les détails pertinents du trade, tels que le prix, la taille et l'heure.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
ID,
MTS,
AMOUNT,
PRICE
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
ID,
MTS,
AMOUNT,
RATE,
PERIOD
],
...
]
]
Le canal Order Books vous permet de suivre l'état du carnet d'ordres Bitfinex. Il est fourni sur une base agrégée par prix, avec une précision personnalisable. Après avoir reçu la réponse, vous recevrez un instantané du carnet, suivi de mises à jour lors de toute modification du carnet.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
PRICE,
COUNT,
AMOUNT
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
RATE,
PERIOD,
COUNT,
AMOUNT
],
...
]
]
Ce sont les carnets d'ordres les plus granulaires.
// on trading pairs (ex. tBTCUSD)
[
CHANNEL_ID,
[
[
ORDER_ID,
PRICE,
AMOUNT
],
...
]
]
// on funding currencies (ex. fUSD)
[
CHANNEL_ID,
[
[
OFFER_ID,
PERIOD,
RATE,
AMOUNT
],
...
]
]
Fournit un moyen d'accéder aux informations de bougies de graphique. Plages de temps :
1m : une minute
5m : cinq minutes
15m : 15 minutes
30m : 30 minutes
1h : une heure
3h : 3 heures
6h : 6 heures
12h : 12 heures
1D : un jour
7D : une semaine
14D : deux semaines
1M : un mois
[
CHANNEL_ID,
[
[
MTS,
OPEN,
CLOSE,
HIGH,
LOW,
VOLUME
],
...
]
]
Ce canal vous permet de rester à jour avec l'état de votre compte. Vous pouvez recevoir des mises à jour sur vos positions, vos soldes, vos ordres et vos trades.
Utilisez la méthode Authenticate pour vous authentifier auprès du serveur et définir les paramètres requis.
Une fois authentifié, vous recevrez des mises à jour de : ordres, positions, transactions, offres de financement, crédits de financement, prêts de financement, portefeuilles, informations de solde, informations de marge, informations de financement, transactions de financement...
Vous pouvez appeler la méthode UnAuthenticate si vous souhaitez vous déconnecter du serveur.