Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

bitx

bausmeier8.9kMIT1.5.1

A simple wrapper for the BitX API.

bitcoin, bitx, api, luno

readme

node-bitx

Build Status

A simple wrapper for the BitX API.

Usage

Add bitx as a dependency:

$ npm install --save bitx

BitX([keyId, keySecret, ][options])

To access the private BitX API methods you must supply your key id and key secret as the first two arguments. If you are only accessing the public API endpoints you can leave these two arguments out.

The optional options argument can be used to override the default options. The default options are equivalent to:

{
  hostname: 'api.mybitx.com',
  port: 443,
  ca: undefined,
  pair: 'XBTZAR'
}

Methods

For details about the API endpoints see https://api.mybitx.com/api.

Callbacks

The arguments passed to the callback function for each method are:

  1. An error or null if no error occurred.
  2. An object containing the data returned by the BitX API.

getTicker([options, ]callback)

GET https://api.mybitx.com/api/1/ticker

Default options:

{
  pair: bitx.pair
}

Example:

bitx.getTicker(function(err, ticker) {});

getAllTickers(callback)

GET https://api.mybitx.com/api/1/tickers

Example:

bitx.getAllTickers(function(err, tickers) {});

getOrderBook([options, ]callback)

GET https://api.mybitx.com/api/1/orderbook

Default options:

{
  pair: bitx.pair
}

Example:

bitx.getOrderBook(function(err, orderBook) {});

getTrades([options, ]callback)

GET https://api.mybitx.com/api/1/trades

Default options:

{
  pair: bitx.pair
}

Example:

bitx.getTrades(function(err, trades) {});

getOrderList([options, ]callback)

GET https://api.mybitx.com/api/1/listorders

Default options:

{
  pair: bitx.pair,
  state: undefined
}

Example:

bitx.getOrderList({state: 'PENDING'}, function(err, orderList) {});

getBalance([asset, ]callback)

GET https://api.mybitx.com/api/1/balance

Example:

bitx.getBalance('ZAR', function(err, balance) {});

getFundingAddress(asset, [options, ]callback)

GET https://api.mybitx.com/api/1/funding_address

Default options:

{
  address: undefined
}

Example:

bitx.getFundingAddress('XBT', {address: 'B1tC0InExAMPL3fundIN6AdDreS5t0Use'}, function(err, fundingAddress) {});

createFundingAddress(asset, callback)

POST https://api.mybitx.com/api/1/funding_address

Example:

bitx.createFundingAddress('XBT', function(err, fundingAddress) {});

postBuyOrder(volume, price, callback)

POST https://api.mybitx.com/api/1/postorder

Example:

bitx.postBuyOrder(9999.99, 0.01, function(err, order) {});

postSellOrder(volume, price, callback)

POST https://api.mybitx.com/api/1/postorder

Example:

bitx.postSellOrder(0.01, 9999.99, function(err, order) {});

postMarketBuyOrder(volume, callback)

POST https://api.mybitx.com/api/1/marketorder

Example:

bitx.postMarketBuyOrder(0.01, function(err, order) {});

postMarketSellOrder(volume, callback)

POST https://api.mybitx.com/api/1/marketorder

Example:

bitx.postMarketSellOrder(0.01, function(err, order) {});

stopOrder(orderId, callback)

POST https://api.mybitx.com/api/1/stoporder

Example:

bitx.stopOrder('BXMC2CJ7HNB88U4', function(err, result) {});

getOrder(orderId, callback)

GET https://api.mybitx.com/api/1/orders/{orderId}

Example:

bitx.getOrder('BXHW6PFRRXKFSB4', function(err, result) {});

getTransactions(asset, [options, ]callback)

GET https://api.mybitx.com/api/1/transactions

Default options:

{
  offset: 0,
  limit: 10
}

Example:

bitx.getTransactions('XBT', {offset: 5, limit: 20}, function(err, transactions) {});

getWithdrawals(callback)

GET https://api.mybitx.com/api/1/withdrawals

Example:

bitx.getWithdrawals(function(err, withdrawals) {});

getWithdrawal(withdrawalId, callback)

GET https://api.mybitx.com/api/1/withdrawals/{withdrawalId}

Example:

bitx.getWithdrawal('1212', function(err, withdrawal) {});

requestWithdrawal(type, amount, callback)

POST https://api.mybitx.com/api/1/withdrawals

Example:

bitx.requestWithdrawal('ZAR_EFT', 1000, function(err, withdrawal) {});

cancelWithdrawal(withdrawalId, callback)

DELETE https://api.mybitx.com/api/1/withdrawals/{withdrawalId}

Example:

bitx.cancelWithdrawal('1212', function(err, withdrawal) {});

Contributing

Like my work? Please donate 1E1sebnWax5Br2mp8y9dox6oX9Snmf42uz.

Don't like it? Open a pull request or create an issue and help me improve it.

changelog

1.5.1

  • Fix an issue with GET requests sent after POST requests

1.5.0

  • Add getOrder method

1.4.2

  • Make asset parameter optional for getBalance

1.4.1

  • Only catch JSON.parse errors (#6)

1.4.0

  • Add pair option to getTicker, getOrderBook and getTrades
  • Add getAllTickers method

1.3.0

  • Add createFundingAddress method
  • Add getTransactions method
  • Accept address option for getFundingAddress
  • Accept state option for getOrderList
  • Add getWithdrawals method
  • Add getWithdrawal method
  • Add requestWithdrawal method
  • Add cancelWithdrawal method

1.2.1

  • Fix path bug (#1)

1.2.0

  • Add getFundingAddress method

1.1.0

  • Support multiple currency pairs
  • BitX.getLimits is now deprecated (use BitX.getBalance instead).
  • Updated to the latest BitX API.
  • Added BitX.getBalance method.

1.0.1

  • Set response encoding to utf8
  • Resolve require path properly