vitaljeevanjot / hollaex-node-lib

HollaEx crypto exchange nodejs library

hollaex-node-lib

HollaEx crypto exchange nodejs library

Usage

const HollaEx = require('hollaex-node-lib');

var client = new HollaEx();

You can pass the apiURL and baseURL of the HollaEx-Enabled exchange to connect to. You can also pass your apiKey and apiSecret generated from the HollaEx-Enabled exchange.

var client = new HollaEx({
	apiURL: <EXCHANGE_API_URL>,
	baseURL: <EXCHANGE_BASE_URL>,
	apiKey: <MY_API_KEY>,
	apiSecret: <MY_API_SECRET>
});

You can also pass the field apiExpiresAfter which is the length of time in seconds each request is valid for. The default value is 60.

There is a list of functions you can call which will be added later and they are not at this point implemented yet.

• Note: v1 has a new authentication mechanism using HMAC signature. HollaEx previously was using JSON Web Token (JWT) which is now changed to HMAC authentication.

Example:

var client = new HollaEx({
	apiURL: <EXCHANGE_API_URL>,
	baseURL: <EXCHANGE_BASE_URL>,
	apiKey: <MY_API_KEY>,
	apiSecret: <MY_API_SECRET>
});

client
	.getTicker('xht-usdt')
	.then((res) => {
		let data = JSON.parse(res);
		console.log('The volume is', data.volume);
	})
	.catch((err) => {
		console.log(err);
	});

Available functions:

Command	Parameters	Description
getTicker	symbol e.g. xht-usdt	Last, high, low, open and close price and volume within the last 24 hours
getOrderbook	symbol (optional) e.g. xht-usdt	Orderbook containing list of bids and asks
getTrade	symbol (optional) e.g. xht-usdt	List of last trades
getConstant		Tick size, min price, max price, min size and max size of each symbol pair
getUser		User's personal information
getBalance		User's wallet balance
getDeposit	currency (optional), limit (default=50, max=100), page (default=1), orderBy (optional) e.g. amount, order (asc or desc, default=asc)	User's list of all deposits
getWithdrawal	currency (optional), limit (default=50, max=100), page (default=1), orderBy (optional) e.g. amount, order (asc or desc, default=asc)	User's list of all withdrawals
requestWithdrawal	currency, amount, address (receipient's)	Create a new withdrawal request. Disable Two-Factor Authentication to be able to use this function. Must confirm within 5 minutes via email to complete withdrawal
getUserTrade	symbol (optional), limit (default=50, max=100), page (default=1)	User's list of all trades
getOrder	orderId	Get specific information about a certain order
getAllOrder	symbol (optional) e.g. xht-usdt	Get the list of all user orders. It can be filter by passing the symbol
createOrder	symbol, side (buy or sell), size (amount), type (market or limit), price	Create a new order
cancelOrder	orderId	Cancel a specific order with its ID
cancelAllOrder	symbol (optional) e.g. xht-usdt	Cancel all open order. It can be filter by passing the symbol

Websocket

Connecting

You can connect and subscribe to different websocket channels for realtime updates.

To connect, use the connect function with the channel you want to subscribe to as the parameter.

const socket = client.connect('orderbook');

To disconnect the websocket, call disconnect on the socket connection.

socket.disconnect();

Channels

Here is the list of channels you can subscribe to:

• orderbook
• trades
• user (Private updates for the user such as balance, user orders etc as explained below)
• all (Subscribes to all events)

For public channels (orderbook, trades), you can subscribe to specific symbols as follows: orderbook:xht-usdt, trades:xht-usdt.

Events

After connecting to the websocket, you can listen for events coming from the server by using the on function.

socket.on(<EVENT>, (data) => {
	console.log(data);
});

Public channels (orderbook, trades) emit events named after the respective channel. For example, the orderbook channel emits the event orderbook.

The private channel user emits the events userInfo, userOrder, userTrade, userWallet, and userUpdate.

Each channel also emits a disconnect, reconnect, error, connect_error, and connect_timeout event.

• disconnect is emitted once when the websocket connection is disconnected from the server.
• reconnect is emitted once when the server connection is reconnected.
• error is emitted when there is an error thrown by the socket connection.
• connect_error is emitted when there is an error while the socket connects.
• connect_timeout is emitted when the socket connection times out.

Private Events

When you subscribe to private updates on user you should listen for the events as follows:

const socket = client.connect('user');

socket.on('userInfo', (data) => {
	console.log(data);
});
socket.on('userOrder', (data) => {
	console.log(data);
});
socket.on('userTrade', (data) => {
	console.log(data);
});
socket.on('userWallet', (data) => {
	console.log(data);
});
socket.on('userUpdate', (data) => {
	console.log(data);
});

userInfo, userOrder, and userTrade are only partial and send data once. These sockets are similar to GET requests and you should not expect any updates after you receive the first set of data.

userWallet gives updates on changes in the user's wallet

userUpdate is what is used for all updates on user's private data.

These are list of userUpdate client gets after subscription.

• userUpdate: Updates related to the user's private information are as follows:

  • order_queued: When user's order is added to the matching engine queue.

  {
  	"action": "update",
  	"type": "order_queued",
  	"data": {
  		"side": "sell",
  		"type": "limit",
  		"price": 0.2,
  		"size": 2,
  		"symbol": "xht-usdt",
  		"id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd",
  		"created_by": 79,
  		"filled": 0
  	}
  }

  • order_processed: When user's order is processed in the matching engine queue.

  {
  	"action": "update",
  	"type": "order_processed",
  	"data": { "id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd" }
  }

  • order_canceled: When user's order is rejected in the queue, so it has not been added to the orderbook.

  {
  	"action": "update",
  	"type": "order_canceled",
  	"data": {
  		"id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd",
  		"message": "Insufficient balance to perform the order."
  	}
  }

  • order_added: When user's order is added to the orderbook.

  {
  	"action": "update",
  	"type": "order_added",
  	"data": {
  		"side": "sell",
  		"type": "limit",
  		"price": 0.2,
  		"size": 2,
  		"symbol": "xht-usdt",
  		"id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd",
  		"created_by": 79,
  		"filled": 0
  	}
  }

  • order_partialy_filled: When user's order is updated because it was taken some part by another order.

  {
  	"action": "update",
  	"type": "order_partialy_filled",
  	"data": {
  		"id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd",
  		"filled": 0.1,
  		"created_by": 79,
  		"side": "sell",
  		"type": "limit",
  		"size": 2,
  		"price": 0.2,
  		"symbol": "xht-usdt"
  	}
  }

  • order_filled: When user's order is taken by another order in a trade.

  {
    "action": "update",
    "type": "order_filled",
    "data": [
      {
        "id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd"
      },
      {
        "id": "bc7717d4-04e9-4430-a21b-08d32b2c34cd"
      },
      ...
    ]
  }

  • order_updated: When user updates the order.

  {
  	"type": "order_updated",
  	"data": {
  		"id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd",
  		"created_by": 79,
  		"price": 0.2,
  		"side": "sell",
  		"size": 2,
  		"type": "limit"
  	}
  }

  • order_removed: When user's order is taken or user cancels order/orders.

  {
    "action": "update",
    "type": "order_removed",
    "data": [
      {
        "id": "ac7717d4-04e9-4430-a21b-08d32b2c34cd"
      },
      {
        "id": "bc7717d4-04e9-4430-a21b-08d32b2c34cd"
      },
      ...
    ]
  }

  • trade: When a trade happens.

  {
    "action": "update",
    "type": "trade",
    "data": [
      {
        "id": "1efd30b6-fcb5-44da-82c1-82d9def2ddbd",
        "side": "sell",
        "symbol": "xht-usdt",
        "size": 2,
        "price": 0.2,
        "timestamp": "2017-07-26T13:20:40.464Z",
        "fee": 0,
      },
      ...
    ]
  }

  • deposit: When user gets a deposit. Status = pending or completed

  {
  	"action": "update",
  	"type": "deposit",
  	"data": {
  		"amount": 3000,
  		"currency": "usdt",
  		"status": false
  	},
  	"balance": {
  		"usdt_balance": 0,
  		"xht_balance": 300000,
  		"updated_at": "2017-07-26T13:20:40.464Z"
  	}
  }

  • withdrawal: When user performs a withdrawal in his account. Status = pending or completed

  {
  	"action": "update",
  	"type": "withdrawal",
  	"data": {
  		"amount": 5000,
  		"currency": "xht",
  		"status": true
  	},
  	"balance": {
  		"usdt_balance": 0,
  		"xht_balance": 300000,
  		"updated_at": "2017-07-26T13:20:40.464Z"
  	}
  }

Example

You can run the example by going to example folder and running:

node example/hollaex.js

Documentation

For adding additional functionalities simply go to index.js and add more features. You can read more about api documentation at https://apidocs.hollaex.com You should create your token on the platform in setting->api keys