Skip to content
Go to file
This branch is 2 commits ahead, 470 commits behind bitfinexcom:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Bitfinex Trading API for Node.JS. Bitcoin, Ether and Litecoin trading

Build Status

A Node.JS reference implementation of the Bitfinex API

  • Official implementation
  • REST v2 API
  • WebSockets v2 API

Documentation at


  npm i bitfinex-api-node

See doc/ for REST2 and WS2 API methods.


Version 2.0.0 of bitfinex-api-node supports the v2 REST and WebSocket APIs. The clients for v1 of those APIs are maintained for backwards compatibility, but deprecated.

As network calls are slow, data is sent as arrays. In order to reconstruct key / value pairs, set opts.transform to true when creating an interface.

The BFX constructor returns a client manager, which can be used to create clients for v1 & v2 of the REST and WebSocket APIs via .rest() and .ws(). The options for the clients can be defined here, or passed in later

const BFX = require('bitfinex-api-node')

const bfx = new BFX({
  apiKey: '...',
  apiSecret: '...',

  ws: {
    autoReconnect: true,
    seqAudit: true,
    packetWDDelay: 10 * 1000

The clients are cached per version/options pair, and default to version 2:

let ws2 = //
ws2 =    // same client
const ws1 =

const rest2 =, {
  // options

The websocket client is recommended for receiving realtime data & notifications on completed actions.

For more examples, check the examples/ folder.

NOTE: v1 REST and WS clients

Both v1 client classes & server APIs have been deprecated, and will be removed. In the meantime, some methods available via RESTv1 have been exposed on RESTv2 to prevent future migration issues. Although the underlying implementation of these methods is likely to change once they are fully ported to v2, the signatures should remain the same.

WS2 Example: Sending an order & tracking status

const ws =

ws.on('error', (err) => console.log(err))
ws.on('open', ws.auth.bind(ws))

ws.once('auth', () => {
  const o = new Order({
    symbol: 'tETHUSD',
    amount: 0.1,
    type: Order.type.MARKET
  }, ws)

  // Enable automatic updates

  o.on('update', () => {
    console.log(`order updated: ${o.serialize()}`)

  o.on('close', () => {
    console.log(`order closed: ${o.status}`)

  o.submit().then(() => {
    console.log(`submitted order ${}`)
  }).catch((err) => {

WS2 Example: Cancel all open orders

const ws =

ws.on('error', (err) => console.log(err))
ws.on('open', ws.auth.bind(ws))

ws.onOrderSnapshot({}, (orders) => {
  if (orders.length === 0) {
    console.log('no open orders')

  console.log(`recv ${orders.length} open orders`)

  ws.cancelOrders(orders).then(() => {
    console.log('cancelled orders')

WS2 Example: Subscribe to trades by pair

const ws =

ws.on('error', (err) => console.log(err))

ws.on('open', () => {

ws.onTrades({ pair: 'BTCUSD' }, (trade) => {
  if (Array.isArray(trade[0])) {
    console.log(`recv snapshot of ${trade.length} trades`)
  } else {
    console.log(`trade: ${JSON.stringify(trade)}`)

Version 2.0.0 Breaking changes:

constructor takes only an options object now, including the API keys.


new BFX(API_KEY, API_SECRET, { version: 2 })

since 2.0.0:

new BFX({ apiKey: '', apiSecret: '' })

trade and orderbook snapshots are emitted as nested lists

To make dealing with snapshots better predictable, snapshots are emitted as an array.

normalized orderbooks for R0

Lists of raw orderbooks (R0) are ordered in the same order as P0, P1, P2, P3


npm test


My websocket won't connect!

Did you call open()? :)

nonce too small

I make multiple parallel request and I receive an error that the nonce is too small. What does it mean?

Nonces are used to guard against replay attacks. When multiple HTTP requests arrive at the API with the wrong nonce, e.g. because of an async timing issue, the API will reject the request.

If you need to go parallel, you have to use multiple API keys right now.

How do te and tu messages differ?

A te packet is sent first to the client immediately after a trade has been matched & executed, followed by a tu message once it has completed processing. During times of high load, the tu message may be noticably delayed, and as such only the te message should be used for a realtime feed.



BITFINEX NodeJS trading API - Bitcoin, Litecoin, and Ether exchange




No packages published