hollaex-node-lib 2.17.0 → 2.18.0

package/README.md

@@ -79,6 +79,9 @@ client
 | `createOrder` | <ul><li>**symbol**: HollaEx trading symbol e.g. `xht-usdt`</li><li>**side** (_enum_=[`buy`, `sell`]): Order side</li><li>**size**: Size of order to place</li><li>**type**: (_enum_=[`market`, `limit`] Order type</li><li>**price**: (_required if limit order type_) Order price</li><li>**opts**: Object with additional params</li><li>**opts.stop**: (_optional_) Stop price for order</li><li>**opts.meta**: (_optional_) Object with additional meta configurations</li><li>**opts.meta.post_only**: (_optional_, _default_=`false`) Make post only order </li><li>**opts.meta.note**: (_optional_) Custom note for order</li></ul> | Create a new order |
 | `cancelOrder` | <ul><li>**orderId**: HollaEx Network order ID</li></ul> | Cancel a specific order with its ID |
 | `cancelAllOrders` | <ul><li>**symbol**: HollaEx trading symbol e.g. `xht-usdt`</li></ul> | Cancel all the active orders of a user, filtered by currency pair symbol |
+| `getMiniCharts` | <ul><li>**assets**: The list of assets to get the mini charts for</li><li>**opts.from**: (_optional_) Start Date</li><li>**opts.to**: (_optional_) End Date</li><li>**opts.quote**: (_optional_) Quote asset to receive prices based on</li></ul> | Get trade history HOLCV for all pairs |
+| `getQuickTradeQuote` | <ul><li>**spending_currency**: Currency symbol of the spending currency</li><li>**receiving_currency**: Currency symbol of the receiving currency</li><li>**opts.spending_amount**: (_optional_) Spending amount</li><li>**opts.receiving_amount**: (_optional_) Receiving amount</li></ul> | Get Quick Trade Quote |
+| `executeOrder` | <ul><li>**token**: Token</li></ul> | Execute Order |
 
 ### Available admin functions:
 
@@ -113,6 +116,7 @@ client
 | `sendExchangeUserEmail` | <ul><li>**userId**:  The identifier of the user</li><li>**mailType**: The mail type for the email payload</li><li>**data**: The content of the mail</li></ul> | Send email to exchange user account by admin |
 | `sendRawEmail` | <ul><li>**receivers**:  The array of emails to send mail</li><li>**html**: The stringified html content</li><li>**opts.title**:  The title of the mail</li><li>**opts.text**:  The text of the mail</li></ul> | Send email to users with custom html by admin |
 | `getOraclePrice` | <ul><li>**assets**:  Assets to convert</li><li>**opts.quote**: Quote coin to convert to</li><li>**opts.amount**:  Amount to convert</li></ul> | Retrieve price conversion |
+| `getExchangeUserBalances` | <ul><li>**opts.userId**:  The identifier of the user to filter by</li><li>**opts.currency**: The currency to filter by, pass undefined to receive data on all currencies</li><li>**opts.format**: Custom format of data set. Enum: ['all', 'csv']</li></ul> | Retrieve user's balances by admin |
 
 
 ### Websocket

package/kit.js

@@ -4,7 +4,7 @@ const WebSocket = require('ws');
 const moment = require('moment');
 const { createRequest, createSignature, generateHeaders, isDatetime, sanitizeDate } = require('./utils');
 const { setWsHeartbeat } = require('ws-heartbeat/client');
-const { each, union, isNumber, isString, isPlainObject, isBoolean, isObject } = require('lodash');
+const { each, union, isNumber, isString, isPlainObject, isBoolean, isObject, isArray } = require('lodash');
 class HollaExKit {
 	constructor(
 		opts = {
@@ -207,64 +207,67 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/user/deposits?`;
+		let path = `${this.baseUrl}/user/deposits`;
+		let params = '?'
 
 		if (isString(opts.currency)) {
-			path += `&currency=${opts.currency}`;
+			params += `&currency=${opts.currency}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order)) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
 		if (isString(opts.address)) {
-			path += `&address=${opts.address}`;
+			params += `&address=${opts.address}`;
 		}
 
 		if (isString(opts.transactionId)) {
-			path += `&transaction_id=${opts.transactionId}`;
+			params += `&transaction_id=${opts.transactionId}`;
 		}
 
 		if (isBoolean(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 
 		if (isBoolean(opts.dismissed)) {
-			path += `&dismissed=${opts.dismissed}`;
+			params += `&dismissed=${opts.dismissed}`;
 		}
 
 		if (isBoolean(opts.rejected)) {
-			path += `&rejected=${opts.rejected}`;
+			params += `&rejected=${opts.rejected}`;
 		}
 
 		if (isBoolean(opts.processing)) {
-			path += `&processing=${opts.processing}`;
+			params += `&processing=${opts.processing}`;
 		}
 
 		if (isBoolean(opts.waiting)) {
-			path += `&waiting=${opts.waiting}`;
+			params += `&waiting=${opts.waiting}`;
 		}
 
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -314,64 +317,65 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/user/withdrawals?`;
+		let path = `${this.baseUrl}/user/withdrawals`;
+		let params = '?'
 
 		if (isString(opts.currency)) {
-			path += `&currency=${opts.currency}`;
+			params += `&currency=${opts.currency}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order)) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
 		if (isString(opts.address)) {
-			path += `&address=${opts.address}`;
+			params += `&address=${opts.address}`;
 		}
 
 		if (isString(opts.transactionId)) {
-			path += `&transaction_id=${opts.transactionId}`;
+			params += `&transaction_id=${opts.transactionId}`;
 		}
 
 		if (isBoolean(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 
 		if (isBoolean(opts.dismissed)) {
-			path += `&dismissed=${opts.dismissed}`;
+			params += `&dismissed=${opts.dismissed}`;
 		}
 
 		if (isBoolean(opts.rejected)) {
-			path += `&rejected=${opts.rejected}`;
+			params += `&rejected=${opts.rejected}`;
 		}
 
 		if (isBoolean(opts.processing)) {
-			path += `&processing=${opts.processing}`;
+			params += `&processing=${opts.processing}`;
 		}
 
 		if (isBoolean(opts.waiting)) {
-			path += `&waiting=${opts.waiting}`;
+			params += `&waiting=${opts.waiting}`;
 		}
-
+		if (params.length > 1) path += params;
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -443,40 +447,43 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/user/trades?`;
+		let path = `${this.baseUrl}/user/trades`;
+		let params = '?';
 
 		if (isString(opts.symbol)) {
-			path += `&symbol=${opts.symbol}`;
+			params += `&symbol=${opts.symbol}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order)) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
 
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -534,48 +541,51 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/orders?`;
+		let path = `${this.baseUrl}/orders`;
+		let params = '?';
 
 		if (isString(opts.symbol)) {
-			path += `&symbol=${opts.symbol}`;
+			params += `&symbol=${opts.symbol}`;
 		}
 
 		if (isString(opts.side) && (opts.side.toLowerCase() === 'buy' || opts.side.toLowerCase() === 'sell')) {
-			path += `&side=${opts.side}`;
+			params += `&side=${opts.side}`;
 		}
 
 		if (isString(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 
 		if (isBoolean(opts.open)) {
-			path += `&open=${opts.open}`;
+			params += `&open=${opts.open}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order)) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -690,19 +700,21 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/oracle/prices?`;
+		let path = `${this.baseUrl}/oracle/prices`;
+		let params = '?';
 
 		if (isArray(assets)) {
-			path += `&assets=${assets}`;
+			params += `&assets=${assets}`;
 		}
 
 		if (isString(opts.quote)) {
-			path += `&quote=${opts.quote}`;
+			params += `&quote=${opts.quote}`;
 		}
 		
 		if (isNumber(opts.amount)) {
-			path += `&amount=${opts.amount}`;
+			params += `&amount=${opts.amount}`;
 		}
+		if (params.length > 1) path += params;
 
 		const headers = generateHeaders(
 			this.headers,
@@ -714,6 +726,126 @@ class HollaExKit {
 		return createRequest(verb, `${this.apiUrl}${path}`, headers);
 	}
 
+	
+	/**
+	 * Get trade history HOLCV for all pairs
+	 * @param {array} assets - The list of assets to get the mini charts for
+	 * @param {string} opts.from - Start Date
+	 * @param {string} opts.to - End data
+	 * @param {string} opts.quote - Quote asset to receive prices based on
+	 * @return {object} A JSON object with trade history info
+	 */
+	getMiniCharts(
+		assets,
+		opts = {
+			from: null,
+			to: null,
+			quote: null,
+		}
+	) {
+		const verb = 'GET';
+		let path = `${this.baseUrl}/minicharts`;
+		let params = '?';
+
+		if (isArray(assets)) {
+			params += `&assets=${opts.assets}`;
+		}
+	
+		if (isString(opts.from)) {
+			params += `&from=${opts.from}`;
+		}
+	
+		if (isString(opts.to)) {
+			params += `&to=${opts.to}`;
+		}
+	
+		if (isString(opts.quote)) {
+			params += `&quote=${opts.quote}`;
+		}
+	
+		if (params.length > 1) path += params;
+	
+		const headers = generateHeaders(
+			this.headers,
+			this.apiSecret,
+			verb,
+			path,
+			this.apiExpiresAfter
+		);
+		return createRequest(verb, `${this.apiUrl}${path}`, headers);
+	}
+	
+	/**
+	 * Get Quick Trade Quote
+	 * @param {string} spending_currency -  Currency symbol of the spending currency
+	 * @param {string} receiving_currency - Currency symbol of the receiving currency
+	 * @param {string} opts.spending_amount - Spending amount
+	 * @param {string} opts.receiving_amount - Receiving amount
+	 */
+	getQuickTradeQuote(
+		spending_currency,
+		receiving_currency,
+		opts = {
+			spending_amount: null,
+			receiving_amount: null,
+		}
+	) {
+		const verb = 'GET';
+		let path = `${this.baseUrl}/quick-trade`;
+		let params = '?';
+	
+		if (isString(spending_currency)) {
+			params += `&spending_currency=${spending_currency}`;
+		}
+	
+		if (isString(receiving_currency)) {
+			params += `&receiving_currency=${receiving_currency}`;
+		}
+
+		if (isString(opts.spending_amount)) {
+			params += `&spending_amount=${opts.spending_amount}`;
+		}
+	
+		if (isString(opts.receiving_amount)) {
+			params += `&receiving_amount=${opts.receiving_amount}`;
+		}
+	
+		if (params.length > 1) path += params;
+	
+		const headers = generateHeaders(
+			this.headers,
+			this.apiSecret,
+			verb,
+			path,
+			this.apiExpiresAfter
+		);
+		return createRequest(verb, `${this.apiUrl}${path}`, headers);
+	}
+
+	/**
+	 * Execute Order
+	 * @param {string} token - Token
+	 */
+	executeOrder(
+		token
+	) {
+		const verb = 'POST';
+		let path = `${this.baseUrl}/order/execute`;
+		const data = {
+			token
+		};
+	
+		const headers = generateHeaders(
+			this.headers,
+			this.apiSecret,
+			verb,
+			path,
+			this.apiExpiresAfter,
+			data
+		);
+		return createRequest(verb, `${this.apiUrl}${path}`, headers, { data });
+	}
+
 	/**
 	 * Get admin exchange information
 	 * @return {object} A json object with the admin exchange information
@@ -773,73 +905,75 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/deposits?`;
-
+		let path = `${this.baseUrl}/admin/deposits`;
+		let params = '?';
 		
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 
 		if (isString(opts.currency)) {
-			path += `&currency=${opts.currency}`;
+			params += `&currency=${opts.currency}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
 		if (isBoolean(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 
 		if (isBoolean(opts.dismissed)) {
-			path += `&dismissed=${opts.dismissed}`;
+			params += `&dismissed=${opts.dismissed}`;
 		}
 
 		if (isBoolean(opts.rejected)) {
-			path += `&rejected=${opts.rejected}`;
+			params += `&rejected=${opts.rejected}`;
 		}
 
 		if (isBoolean(opts.processing)) {
-			path += `&processing=${opts.processing}`;
+			params += `&processing=${opts.processing}`;
 		}
 
 		if (isBoolean(opts.waiting)) {
-			path += `&waiting=${opts.waiting}`;
+			params += `&waiting=${opts.waiting}`;
 		}
 
 		if (isString(opts.transactionId)) {
-			path += `&transaction_id=${opts.transactionId}`;
+			params += `&transaction_id=${opts.transactionId}`;
 		}
 
 		if (isString(opts.address)) {
-			path += `&address=${opts.address}`;
+			params += `&address=${opts.address}`;
 		}
 
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
 
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -892,72 +1026,74 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/withdrawals?`;
+		let path = `${this.baseUrl}/admin/withdrawals`;
+		let params = '?';
 
 		if (isString(opts.currency)) {
-			path += `&currency=${opts.currency}`;
+			params += `&currency=${opts.currency}`;
 		}
 
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 
 		if (isString(opts.transactionId)) {
-			path += `&transaction_id=${opts.transactionId}`;
+			params += `&transaction_id=${opts.transactionId}`;
 		}
 
 		if (isString(opts.address)) {
-			path += `&address=${opts.address}`;
+			params += `&address=${opts.address}`;
 		}
 
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
 		if (isBoolean(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 
 		if (isBoolean(opts.dismissed)) {
-			path += `&dismissed=${opts.dismissed}`;
+			params += `&dismissed=${opts.dismissed}`;
 		}
 
 		if (isBoolean(opts.rejected)) {
-			path += `&rejected=${opts.rejected}`;
+			params += `&rejected=${opts.rejected}`;
 		}
 
 		if (isBoolean(opts.processing)) {
-			path += `&processing=${opts.processing}`;
+			params += `&processing=${opts.processing}`;
 		}
 
 		if (isBoolean(opts.waiting)) {
-			path += `&waiting=${opts.waiting}`;
+			params += `&waiting=${opts.waiting}`;
 		}
 
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
 
+		if (params.length > 1) path += params;
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -1006,7 +1142,7 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'POST';
-		let path = `${this.baseUrl}/admin/transfer?`;
+		let path = `${this.baseUrl}/admin/transfer`;
 		const data = {
 			sender_id: senderId,
 			receiver_id: receiverId,
@@ -1120,7 +1256,7 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'PUT';
-		let path = `${this.baseUrl}/admin/mint?`;
+		let path = `${this.baseUrl}/admin/mint`;
 		const data = {
 			transaction_id: transactionId
 		};
@@ -1196,7 +1332,7 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'POST';
-		let path = `${this.baseUrl}/admin/burn?`;
+		let path = `${this.baseUrl}/admin/burn`;
 		const data = {
 			user_id: userId,
 			currency,
@@ -1259,7 +1395,7 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'PUT';
-		let path = `${this.baseUrl}/admin/burn?`;
+		let path = `${this.baseUrl}/admin/burn`;
 		const data = {
 			transaction_id: transactionId
 		};
@@ -1331,27 +1467,31 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/check-transaction?`;
-	
+		let path = `${this.baseUrl}/admin/check-transaction`;
+		let params = '?';
+
 		if (isString(currency)) {
-			path += `&currency=${currency}`;
+			params += `&currency=${currency}`;
 		}
 	
 		if (isString(transactionId)) {
-			path += `&transaction_id=${transactionId}`;
+			params += `&transaction_id=${transactionId}`;
 		}
 	
 		if (isString(address)) {
-			path += `&address=${address}`;
+			params += `&address=${address}`;
 		}
 	
 		if (isString(network)) {
-			path += `&network=${network}`;
+			params += `&network=${network}`;
 		}
 	
 		if (isBoolean(opts.isTestnet)) {
-			path += `&is_testnet=${opts.isTestnet}`;
+			params += `&is_testnet=${opts.isTestnet}`;
 		}
+
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -1417,43 +1557,46 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/trades?`;
+		let path = `${this.baseUrl}/admin/trades`;
+		let params = '?';
 		
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.symbol)) {
-			path += `&symbol=${opts.symbol}`;
+			params += `&symbol=${opts.symbol}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 	
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 	
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
+
+		if (params.length > 1) path += params;
 	
 		const headers = generateHeaders(
 			this.headers,
@@ -1497,52 +1640,55 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/orders?`;
+		let path = `${this.baseUrl}/admin/orders`;
+		let params = '?';
 		
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 	
 		if (isString(opts.side) && (opts.side === 'buy' || opts.side === 'sell')) {
-			path += `&side=${opts.side}`;
+			params += `&side=${opts.side}`;
 		}
 		
 		if (isString(opts.status)) {
-			path += `&status=${opts.status}`;
+			params += `&status=${opts.status}`;
 		}
 	
 		if (isBoolean(opts.open)) {
-			path += `&open=${opts.open}`;
+			params += `&open=${opts.open}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.symbol)) {
-			path += `&symbol=${opts.symbol}`;
+			params += `&symbol=${opts.symbol}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 	
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -1561,15 +1707,18 @@ class HollaExKit {
 	 */
 	cancelExchangeUserOrder(userId, orderId) {
 		const verb = 'DELETE';
-		let path = `${this.baseUrl}/admin/order?`;
+		let path = `${this.baseUrl}/admin/order`;
+		let params = '?';
 	
 		if (isString(orderId)) {
-			path += `&order_id=${orderId}`;
+			params += `&order_id=${orderId}`;
 		}
 	
 		if (isNumber(userId)) {
-			path += `&user_id=${userId}`;
+			params += `&user_id=${userId}`;
 		}
+
+		if (params.length > 1) path += params;
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -1613,55 +1762,57 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/users?`;
+		let path = `${this.baseUrl}/admin/users`;
+		let params = '?';
 		
 		if (isNumber(opts.userId)) {
-			path += `&id=${opts.userId}`;
+			params += `&id=${opts.userId}`;
 		}
 	
 		if (isString(opts.search)) {
-			path += `&search=${opts.search}`;
+			params += `&search=${opts.search}`;
 		}
 		
 		if (isString(opts.type)) {
-			path += `&type=${opts.type}`;
+			params += `&type=${opts.type}`;
 		}
 	
 		if (isBoolean(opts.pending)) {
-			path += `&pending=${opts.pending}`;
+			params += `&pending=${opts.pending}`;
 		}
 	
 		if (isString(opts.pendingType) && (opts.pendingType === 'id' ||opts.pendingType === 'bank')) {
-			path += `&pending_type=${opts.pendingType}`;
+			params += `&pending_type=${opts.pendingType}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 	
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 	
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
+		if (params.length > 1) path += params;
 	
 		const headers = generateHeaders(
 			this.headers,
@@ -1907,55 +2058,58 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/user/wallet?`;
+		let path = `${this.baseUrl}/admin/user/wallet`;
+		let params = '?';
 
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 	
 		if (isString(opts.currency)) {
-			path += `&currency=${opts.currency}`;
+			params += `&currency=${opts.currency}`;
 		}
 		
 		if (isString(opts.address)) {
-			path += `&address=${opts.address}`;
+			params += `&address=${opts.address}`;
 		}
 
 		if (isString(opts.network)) {
-			path += `&network=${opts.network}`;
+			params += `&network=${opts.network}`;
 		}
 
 		if (isBoolean(opts.isValid)) {
-			path += `&is_valid=${opts.isValid}`;
+			params += `&is_valid=${opts.isValid}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 	
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
+
+		if (params.length > 1) path += params;
 	
 		const headers = generateHeaders(
 			this.headers,
@@ -2040,40 +2194,43 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/logins?`;
+		let path = `${this.baseUrl}/admin/logins`;
+		let params = '?';
 		
 		if (isNumber(opts.userId)) {
-			path += `&user_id=${opts.userId}`;
+			params += `&user_id=${opts.userId}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 	
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
 	
 		if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
-			path += `&format=${opts.format}`;
+			params += `&format=${opts.format}`;
 		}
 	
+		if (params.length > 1) path += params;
+
 		const headers = generateHeaders(
 			this.headers,
 			this.apiSecret,
@@ -2154,36 +2311,38 @@ class HollaExKit {
 		}
 	) {
 		const verb = 'GET';
-		let path = `${this.baseUrl}/admin/user/affiliation?`;
-	
+		let path = `${this.baseUrl}/admin/user/affiliation`;
+		let params = '?';
 		
 		if (isNumber(userId)) {
-			path += `&user_id=${userId}`;
+			params += `&user_id=${userId}`;
 		}
 	
 		if (isNumber(opts.limit)) {
-			path += `&limit=${opts.limit}`;
+			params += `&limit=${opts.limit}`;
 		}
 	
 		if (isNumber(opts.page)) {
-			path += `&page=${opts.page}`;
+			params += `&page=${opts.page}`;
 		}
 	
 		if (isString(opts.orderBy)) {
-			path += `&order_by=${opts.orderBy}`;
+			params += `&order_by=${opts.orderBy}`;
 		}
 	
 		if (isString(opts.order) && (opts.order === 'asc' || opts.order === 'desc')) {
-			path += `&order=${opts.order}`;
+			params += `&order=${opts.order}`;
 		}
 	
 		if (isDatetime(opts.startDate)) {
-			path += `&start_date=${sanitizeDate(opts.startDate)}`;
+			params += `&start_date=${sanitizeDate(opts.startDate)}`;
 		}
 	
 		if (isDatetime(opts.endDate)) {
-			path += `&end_date=${sanitizeDate(opts.endDate)}`;
+			params += `&end_date=${sanitizeDate(opts.endDate)}`;
 		}
+
+		if (params.length > 1) path += params;
 	
 	
 		const headers = generateHeaders(
@@ -2279,7 +2438,46 @@ class HollaExKit {
 		return createRequest(verb, `${this.apiUrl}${path}`, headers, { data });
 	}
 	
-	
+	/**
+	 * Retrieve user's balances by admin
+	 * @param {number} opts.userId - The identifier of the user to filter by
+	 * @param {number} opts.currency - The currency to filter by, pass undefined to receive data on all currencies
+	 * @param {string} opts.format - Custom format of data set. Enum: ['all', 'csv']
+	 * @return {object} A JSON object with referral info
+	 */
+		getExchangeUserBalances(
+			opts = {
+				userId: null,
+				currency: null,
+				format: null
+			}
+		) {
+			const verb = 'GET';
+			let path = `${this.baseUrl}/admin/balances?`;
+		
+			
+			if (isNumber(opts.userId)) {
+				path += `&user_id=${opts.userId}`;
+			}
+			
+			if (isString(opts.currency)) {
+				path += `&currency=${opts.currency}`;
+			}
+			
+			if (isString(opts.format) && ['csv', 'all'].includes(opts.format)) {
+				path += `&format=${opts.format}`;
+			}
+		
+			const headers = generateHeaders(
+				this.headers,
+				this.apiSecret,
+				verb,
+				path,
+				this.apiExpiresAfter
+			);
+			return createRequest(verb, `${this.apiUrl}${path}`, headers);
+		}
+
 	/**
 	 * Connect to hollaEx websocket and listen to an event
 	 * @param {array} events - The events to listen to

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "hollaex-node-lib",
-	"version": "2.17.0",
+	"version": "2.18.0",
 	"description": "hollaex api and websocket library for nodejs",
 	"main": "index.js",
 	"dependencies": {