Introduction

All shell commands are CURL. You can read more about CURL here.

HollaEx provides a complete RESTful API for developers which allows full access to all the functionalities on the exchange. HollaEx also support websocket for real-time updates.

These endpoints are categorized into public and private. Public endpoints allow you to access public information such as price ticker, orderbook etc while private endpoints require authentication and allow you to get your balance, active orders as well as placing orders.

We have language bindings in Shell with CURL and you can view code examples in the dark area on the right.

Authentication

To authorize, use this code:

# With shell, you can just pass the correct header with each request
curl -X POST
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "api_endpoint_here"

Make sure to replace $API_KEY, $API_SIGNATURE, and $API_EXPIRES with your own key, signature, and expires values.

HollaEx uses HMAC-SHA256 authentication for private user access to the API. HMAC-SHA256 takes a string and secret key (your api-secret) and outputs an encoded signature (your api-signature). The string being encoded should follow the format ${METHOD}${PATH}${api-expires}, where METHOD is the HTTP method of the request, PATH is the path of the request, and api-expires is a unix timestamp indicating when the request expires. If the request includes a body, the JSON body object should be appended to the string being encoded e.g. ${METHOD}${PATH}${api-expires}${JSON_BODY}. You can use an online HMAC generator to generate the signature.

Examples of strings being encoded:

GET request to https://api.hollaex.com/v2/user/balance that expires at 1575516146
- GET/v2/user/balance1575516146
POST request to https://api.hollaex.com/v2/order that expires at 1575516146 with body {"symbol":"btc-usdt","side":"buy","size":0.001,"type":"market"}
- POST/v2/order1583284849{"symbol":"btc-usdt","side":"buy","size":0.001,"type":"market"}
DELETE request to https://api.hollaex.com/v2/order?order_id=23a75975-3ad9-448c-8f3e-836c1f61f248 that expires at 1697543568
- DELETE/v2/order?order_id=23a75975-3ad9-448c-8f3e-836c1f61f248

You can register for a new HollaEx api-key and api-secret in the security section of hollaex.com.

HollaEx expects api-key, api-signature, and api-expires to be included in all Private API requests to the server in the request header with the following format:

api-key: <API_KEY>
api-signature: <API_SIGNATURE>
api-expires: <API_EXPIRES>

You must replace API_KEY, API_SIGNATURE, and API_EXPIRES with your own values.

API Client Libraries

Client libraries make it simple to utilize our API. Currently, there are two libraries for HollaEx that support three languages:

HollaEx Node Library - Our official library that supports Node.js. Connects to both our API and websocket.
CCXT - An authorized library that supports Node.js, PHP, and Python. Connects to our API.

Public

Health

Request

curl -X GET "https://api.hollaex.com/v2/health"

Response

{
    "name": "HollaEx",
    "version": "2.1.0",
    "host": "https://api.hollaex.com",
    "basePath": "/v2"
}

This endpoint retrieves the exchange's basic information and checks its health.

HTTP Request

GET https://api.hollaex.com/v2/health

Constants

Request

curl -X GET "https://api.hollaex.com/v2/constants"

Response

{
    "coins": {
        "xht": {
            "id": 1,
            "fullname": "HollaEx Token",
            "symbol": "xht",
            "active": true,
            "verified": true,
            "allow_deposit": true,
            "allow_withdrawal": true,
            "withdrawal_fee": 20,
            "min": 1,
            "max": 1000000,
            "increment_unit": 1,
            "created_at": "2019-08-09T10:45:43.367Z",
            "updated_at": "2019-10-31T05:08:18.907Z",
            "logo": "https://bitholla.s3.ap-northeast-2.amazonaws.com/icon/XHT-hollaex-asset-01.svg",
            "code": "xht",
            "is_public": true,
            "meta": {},
            "estimated_price": null,
            "description": null,
            "type": "blockchain",
            "network": "eth",
            "standard": "erc-20",
            "issuer": "HollaEx",
            "withdrawal_fees": {
                "eth": 20,
                "trx": 1
            },
            "created_by": 1
        },
        "usdt": {
            "id": 6,
            "fullname": "USD Tether",
            "symbol": "usdt",
            "active": true,
            "verified": true,
            "allow_deposit": true,
            "allow_withdrawal": true,
            "withdrawal_fee": 20,
            "min": 0.1,
            "max": 10000000,
            "increment_unit": 0.1,
            "created_at": "2019-08-09T10:45:43.367Z",
            "updated_at": "2021-04-20T03:02:48.635Z",
            "logo": "https://bitholla.s3.ap-northeast-2.amazonaws.com/exchange/icons/usdt.",
            "code": "usdt",
            "is_public": true,
            "meta": {},
            "estimated_price": 1,
            "description": null,
            "type": "blockchain",
            "network": "eth,trx",
            "standard": "erc-20",
            "issuer": "HollaEx",
            "withdrawal_fees": null,
            "created_by": 1
        },
        ...
    },
    "pairs": {
        "xht-usdt": {
            "id": 1,
            "name": "xht-usdt",
            "pair_base": "xht",
            "pair_2": "usdt",
            "min_size": 0.1,
            "max_size": 10000000,
            "min_price": 0.01,
            "max_price": 10000,
            "increment_size": 0.1,
            "increment_price": 0.0001,
            "active": true,
            "verified": true,
            "code": "xht-usdt",
            "is_public": true,
            "estimated_price": 0.1,
            "created_at": "2019-08-09T10:45:43.353Z",
            "updated_at": "2019-08-09T10:45:43.353Z",
            "created_by": 1
        },
        ...
    }
}

This endpoint retrieves system information for coins and pairs.

HTTP Request

GET https://api.hollaex.com/v2/constants

Kit

Request

curl -X GET "https://api.hollaex.com/v2/kit"

Response

{
    "meta": {...},
    "color": {...},
    "icons": {...},
    "links": {...},
    "title": "HollaEx",
    "captcha": {
        "site_key": ""
    },
    "strings": {...},
    "api_name": "HollaEx",
    "defaults": {
        "theme": "dark",
        "language": "en"
    },
    "features": {...},
    "interface": {
        "type": "full"
    },
    "user_meta": {...},
    "logo_image": "https://bitholla-sandbox.s3.ap-northeast-2.amazonaws.com/exchange/Sandbox_HollaEx/EXCHANGE_LOGO__dark.png",
    "description": "HollaEx is a global cryptocurrency exchange for professional trading built based on HollaEx Kit technology developed and managed by bitHolla. Not only it is open for trading but it also allows businesses and individuals to branch out and create their own exchange based on it in the HollaEx Network. HollaEx Token (XHT) is the native token of HollaEx Network used as a collateral among exchanges.",
    "injected_html": {...},
    "injected_values": [...],
    "native_currency": "usdt",
    "setup_completed": true,
    "valid_languages": "en,fa,ko,ar,pt,ja,ru",
    "new_user_is_activated": true,
    "email_verification_required": true,
    "info": {
        "name": "HollaEx",
        "active": true,
        "url": "https://api.hollaex.com",
        "is_trial": false,
        "created_at": "2020-10-05T06:46:27.272Z",
        "expiry": "2021-02-04T06:46:27.000Z",
        "collateral_level": "member",
        "type": "Cloud",
        "plan": "crypto",
        "period": "year",
        "status": true,
        "initialized": true
    }
}

This endpoint retrieves system kit configurations for the client.

HTTP Request

GET https://api.hollaex.com/v2/kit

Tiers

Request

curl -X GET "https://api.hollaex.com/v2/tiers"

Response

{
    "1": {
        "id": 1,
        "name": "Base Trader",
        "icon": "",
        "description": "basic tier",
        "deposit_limit": 0,
        "withdrawal_limit": 0,
        "fees": {
            "maker": {
                "xht-usdt": 0.2,
                "xmr-usdt": 0.2,
                "eth-usdt": 0.2,
                "btc-usdt": 0.2,
                "eth-btc": 0.2
            },
            "taker": {
                "xht-usdt": 0.2,
                "xmr-usdt": 0.2,
                "eth-usdt": 0.2,
                "btc-usdt": 0.2,
                "eth-btc": 0.2
            }
        },
        "note": "",
        "created_at": "2020-10-28T02:00:57.128Z",
        "updated_at": "2021-01-13T15:42:30.615Z"
    },
    "2": {
        "id": 2,
        "name": "VIP Trader",
        "icon": "",
        "description": "vip tier",
        "deposit_limit": 0,
        "withdrawal_limit": 0,
        "fees": {
            "maker": {
                "xht-usdt": 0,
                "xmr-usdt": 0,
                "eth-usdt": 0,
                "btc-usdt": 0,
                "eth-btc": 0
            },
            "taker": {
                "xht-usdt": 0,
                "xmr-usdt": 0,
                "eth-usdt": 0,
                "btc-usdt": 0,
                "eth-btc": 0
            }
        },
        "note": "",
        "created_at": "2020-10-28T02:01:12.299Z",
        "updated_at": "2021-01-07T08:21:15.300Z"
    },
    ...
}

This endpoint retrieves system tier levels for users.

HTTP Request

GET https://api.hollaex.com/v2/tiers

Ticker

Request

curl -X GET "https://api.hollaex.com/v2/ticker?symbol=xht-usdt"

Response

{
    "open": 0.54,
    "close": 0.54,
    "high": 0.54,
    "low": 0.54,
    "last": 0.54,
    "volume": 18653.3,
    "timestamp": "2021-04-28T03:05:24.996Z"
}

This endpoint retrieves ticker information for a pair.

HTTP Request

GET https://api.hollaex.com/v2/ticker?symbol=${symbol}

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol (xht-usdt)

Tickers

Request

curl -X GET "https://api.hollaex.com/v2/tickers"

Response

{
    "xht-usdt": {
        "time": "2021-04-27T03:05:41.012Z",
        "open": 0.54,
        "close": 0.54,
        "high": 0.54,
        "low": 0.54,
        "last": 0.54,
        "volume": 18653.3,
        "symbol": "xht-usdt"
    },
    ...
}

This endpoint retrieves ticker information for all pairs.

HTTP Request

GET https://api.hollaex.com/v2/tickers

Orderbook

Request

curl -X GET "https://api.hollaex.com/v2/orderbook?symbol=xht-usdt"

Response

{
    "xht-usdt": {
        "bids": [
            [0.212,8],
            [0.21,5],
            [0.208,15],
            [0.206,583],
            [0.205,1000],
            [0.204,1000],
            [0.203,1000],
            [0.202,1000],
            [0.201,1000],
            [0.2,1000]
        ],
        "asks": [
            [0.23,45],
            [0.24,824],
            [0.248,10]
        ],
        "timestamp": "2018-03-02T21:36:29.395Z"
    }
}

This endpoint retrieves 10 level bids and 10 level asks of the orderbook for a symbol.

HTTP Request

GET https://api.hollaex.com/v2/orderbook?symbol=${symbol}

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol (xht-usdt, etc.)

Orderbooks

Request

curl -X GET "https://api.hollaex.com/v2/orderbooks"

Response

{
    "xht-usdt": {
        "bids": [...],
        "asks": [...],
        "timestamp": "2018-03-02T21:36:29.395Z"
    },
    "btc-usdt": {
        "bids": [...],
        "asks": [...],
        "timestamp": "2018-03-02T21:36:29.395Z"
    },
    ...
}

This endpoint retrieves 10 level bids and 10 level asks of the orderbook for all symbols.

HTTP Request

GET https://api.hollaex.com/v2/orderbooks

Trades

Request

curl -X GET "https://api.hollaex.com/v2/trades?symbol=xht-usdt"

Response

{
    "xht-usdt": [
        {
            "size": 10,
            "price": 0.2,
            "side": "buy",
            "timestamp": "2018-03-23T04:00:20.744Z"
        },
        {
            "size": 5,
            "price": 0.21,
            "side": "buy",
            "timestamp": "2018-03-23T03:32:38.927Z"
        },
        {
            "size": 5,
            "price": 0.23,
            "side": "sell",
            "timestamp": "2018-03-23T03:13:42.361Z"
        }
    ],
    ...
}

This endpoint retrieves the last 30 trades.

HTTP Request

GET https://api.hollaex.com/v2/trades

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Optional	The currency pair symbol (xht-usdt, etc.)

Chart

Request

curl -X GET "https://api.hollaex.com/v2/chart?symbol=xht-usdt&resolution=1D&from=1616987453&to=1619579513"

Response

[
    {
        "time": "2021-04-14T00:00:00.000Z",
        "close": 0.25,
        "high": 0.21,
        "low": 0.25,
        "open": 0.21,
        "symbol": "xht-usdt",
        "volume": 204.2
    },
    {
        "time": "2021-04-19T00:00:00.000Z",
        "close": 0.25,
        "high": 0.25,
        "low": 0.25,
        "open": 0.25,
        "symbol": "xht-usdt",
        "volume": 437.8
    },
    ...
]

This endpoint retrieves a trading pair's trade history HOLCV.

HTTP Request

GET https://api.hollaex.com/v2/chart?symbol=${symbol}&resolution=${resolution}&from=${from}&to=${to}

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	Symbol to get
resolution	string	Required	Time interval resolution (15, 60, 240, 1D, 1W)
from	string	Required	Beginning UNIX timestamp
to	string	Required	Ending UNIX timestamp

Charts

Request

curl -X GET "https://api.hollaex.com/v2/charts?resolution=1D&from=1551663947&to=1582768007"

Response

{
    "xht-usdt": [
        {
            "time": "2020-01-01T00:00:00.000Z",
            "close": 0.2,
            "high": 0.23,
            "low": 0.2,
            "open": 0.23,
            "symbol": "xht-usdt",
            "volume": 13538
        },
        {
            "time": "2020-01-02T00:00:00.000Z",
            "close": 0.2,
            "high": 0.2,
            "low": 0.2,
            "open": 0.2,
            "symbol": "xht-usdt",
            "volume": 54
        },
        {
            "time": "2020-01-03T00:00:00.000Z",
            "close": 0.2,
            "high": 0.201,
            "low": 0.2,
            "open": 0.2,
            "symbol": "xht-usdt",
            "volume": 25982
        },
        ...
    ],
    "btc-usdt": [...],
    ...
}

This endpoint retrieves trade history HOLCV for all pairs.

HTTP Request

GET https://api.hollaex.com/v2/charts?resolution=${resolution}&from=${from}&to=${to}

PARAMETERS

Parameter	Type	Required/Optional	Description
resolution	string	Required	Time interval resolution (15, 60, 240, 1D, 1W)
from	string	Required	Beginning UNIX timestamp
to	string	Required	Ending UNIX timestamp

MiniCharts

Request

curl -X GET "https://api.hollaex.com/v2/minicharts?assets=btc,xht&quote=xht"

Response

{
    "btc": [
        {
            "time": "2023-09-12T11:59:00.548Z",
            "price": "25000.00",
            "symbol": "btc",
            "quote": "usdt"
        },
      ...
    ],
    "xht": [
        {
            "time": "2023-09-12T11:59:00.548Z",
            "price": "0.18",
            "symbol": "xht",
            "quote": "usdt"
        },
       ...
    ]
}

Get trade history HOLCV for all pairs

HTTP Request

GET https://api.hollaex.com/v2/minicharts

PARAMETERS

Parameter	Type	Required/Optional	Description
assets	array	Required	The list of assets to get the mini charts for
from	string	Optional	Beginning UNIX timestamp
to	string	Optional	Ending UNIX timestamp
quote	string	Optional	Quote asset to receive prices based on

Oracle Prices

Request

curl -X GET "https://api.hollaex.com/v2/oracle/prices?&assets=xht&quote=usdt&amount=1"

Response

{ "xht": 0.19 }

Retrieve price conversion

HTTP Request

GET https://api.hollaex.com/v2/oracle/prices

PARAMETERS

Parameter	Type	Required/Optional	Description
assets	array	Required	Assets to convert in array
quote	string	Optional	Quote coin to convert to
amount	number	Optional	Amount to convert

Quick Trade

Request

curl -X GET "https://api.hollaex.com/v2/quick-trade?&spending_currency=btc&receiving_currency=usdt&spending_amount=0.0001"

Response

{
  "spending_currency": "btc",
  "receiving_currency": "usdt",
  "spending_amount": 0.0001,
  "type": "market",
  "receiving_amount": 3.45,
  "token": "wTqpH3aXjfPTnZbK4P94vUbwg7HGk05i",
  "expiry": "2023-11-09T20:47:21.323Z"        
}

Get Quick Trade Quote

HTTP Request

GET https://api.hollaex.com/v2/quick-trade

PARAMETERS

Parameter	Type	Required/Optional	Description
spending_currency	string	Required	Currency symbol of the spending currency
receiving_currency	string	Required	Currency symbol of the receiving currency
spending_amount	string	Optional	Spending amount
receiving_amount	string	Optional	Receiving amount

Private

You must replace API_KEY, API_SIGNATURE, and API_EXPIRES with your own values in the header of all private http requests. Refer to the authentication section above to learn more.

Get User

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user"

Response

{
    "id": 1,
    "email": "fight@club.com",
    "full_name": "Tyler Durden",
    "gender": true,
    "nationality": "USA",
    "dob": "2017-07-21T17:32:28.000Z",
    "phone_number": "",
    "address": {
        "city": "Bradford",
        "address": "537 Paper Street",
        "country": "USA",
        "postal_code": "19808"
    },
    "id_data": {
        "type": "passport",
        "number": "999",
        "issued_date": "2017-07-21T17:32:28.000Z",
        "expiration_date": "2017-07-21T17:32:28.000Z"
    },
    "bank_account": [...],
    "crypto_wallet": {},
    "verification_level": 2,
    "email_verified": true,
    "otp_enabled": false,
    "activated": true,
    "username": "narrator",
    "affiliation_code": "STRING",
    "settings": {
        "chat": {
            "set_username": true
        },
        "risk": {
            "popup_warning": true,
            "order_portfolio_percentage": 90
        },
        "audio": {
            "all": true,
            "order_placed": true,
            "public_trade": true,
            "click_amounts": true,
            "order_canceled": true,
            "order_completed": true,
            "quick_trade_success": true,
            "quick_trade_timeout": true,
            "get_quote_quick_trade": true,
            "order_partially_completed": true
        },
        "language": "en",
        "interface": {
            "theme": "dark",
            "order_book_levels": 20
        },
        "notification": {
            "popup_order_completed": false,
            "popup_order_confirmation": false,
            "popup_order_partially_filled": false
        }
    },
    "affiliation_rate": 0,
    "network_id": 90,
    "created_at": "2020-10-06T11:01:46.715Z",
    "updated_at": "2021-02-16T07:48:03.108Z",
    "balance": {
        "usdt_balance": 0,
        "usdt_available": 0,
        "xht_balance": 0,
        "xht_available": 0,
        ...,
        "updated_at": "2021-02-16T05:48:28.014Z"
    },
    "wallet": [
        {
            "currency": "xht",
            "address": "0xb9b424250b1d5025f69d5c099b7a90f0a0a9c275",
            "network": "eth",
            "standard": null,
            "is_valid": true,
            "created_at": "2021-04-07T07:23:33.212Z"
        },
        {
            "currency": "usdt",
            "address": "0xb9b424250b1d5025f69d5c099b7a90f0a0a9c275",
            "network": "eth",
            "standard": null,
            "is_valid": true,
            "created_at": "2021-04-22T13:46:54.014Z"
        },
        ...
    ]
}

This endpoint gets user's information, wallet address as well as his balance.

HTTP Request

GET https://api.hollaex.com/v2/user

Get Balance

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user/balance"

Response

{
    "xht_balance": 0,
    "xht_available": 0,
    "usdt_balance": 0,
    "usdt_available": 0,
    ...
    "updated_at": "2018-03-23T04:14:08.705Z"
}

This endpoint gets a user's balance.

HTTP Request

GET https://api.hollaex.com/v2/user/balance

Get Deposits

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user/deposits"

Response

{
    "count": 1,
    "data": [
        {
            "id": 229,
            "amount": 1,
            "fee": 0,
            "address": "string",
            "transaction_id": "string",
            "status": true,
            "dismissed": false,
            "rejected": false,
            "processing": false,
            "waiting": false,
            "description": "",
            "type": "deposit",
            "currency": "usdt",
            "network": "eth",
            "created_at": "2021-02-16T05:48:28.011Z",
            "updated_at": "2021-02-16T05:48:28.011Z",
            "user_id": 90
        }
    ]
}

This endpoint displays user's deposits

HTTP Request

GET https://api.hollaex.com/v2/user/deposits

PARAMETERS

Parameter	Type	Required/Optional	Description
currency	string	Optional	The currency pair symbol
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
transaction_id	string	Optional	Get deposits with this transaction ID
address	string	Optional	Get deposits made to this address
status	boolean	Optional	Completed status of deposits to get
dismissed	boolean	Optional	Dismissed status of deposits to get
rejected	boolean	Optional	Rejected status of deposits to get
processing	boolean	Optional	Processing status of deposits to get
waiting	boolean	Optional	Waiting status of deposits to get
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data in ISO 8601 format
format	string	Optional	Pass value csv to download csv file

Get Withdrawals

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user/withdrawals"

Response

{
    "count": 1,
    "data": [
        {
            "id": 224,
            "amount": 1,
            "fee": 0,
            "address": "string",
            "transaction_id": "string",
            "status": true,
            "dismissed": false,
            "rejected": false,
            "processing": false,
            "waiting": false,
            "description": "",
            "type": "withdrawal",
            "currency": "usdt",
            "network": "eth",
            "created_at": "2021-02-15T02:36:47.167Z",
            "updated_at": "2021-02-15T02:36:47.167Z",
            "user_id": 90
        }
    ]
}

This endpoint displays user's withdrawals

HTTP Request

GET https://api.hollaex.com/v2/user/withdrawals

PARAMETERS

Parameter	Type	Required/Optional	Description
currency	string	Optional	The currency pair symbol (xht-usdt)
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
transaction_id	string	Optional	Get withdrawals with this transaction ID
address	string	Optional	Get withdrawals made to this address
status	boolean	Optional	Completed status of withdrawals to get
dismissed	boolean	Optional	Dismissed status of withdrawals to get
rejected	boolean	Optional	Rejected status of withdrawals to get
processing	boolean	Optional	Processing status of withdrawals to get
waiting	boolean	Optional	Waiting status of withdrawals to get
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data i ISO 8601 format
format	string	Optional	Pass value csv to download csv file

Get Withdrawal Fee

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user/withdrawal/fee?symbol=$symbol"

Response

{
    "fee": 0.001
}

This endpoint gets the withdrawal fee for a certain currency

HTTP Request

GET https://api.hollaex.com/v2/user/withdrawal/fee?currency=${currency}

PARAMETERS

Parameter	Type	Required/Optional	Description
currency	string	Required	The desired currency e.g. xht

Withdrawal

Request

curl -X POST
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  -H "Content-Type: application/json"
  -d '{"currency":$currency,"amount":$amount,"address":$address}'
  "https://api.hollaex.com/v2/user/withdrawal"

Response

{
    "message": "Withdrawal request is in the queue and will be processed.",
    "id": 1000,
    "transaction_id": "d696dd5d-3226-4662-8d86-3da3d8eb68ff",
    "amount": 1,
    "currency": "xht",
    "fee": 20,
    "fee_coin": "xht"
}

This endpoint directly creates a withdrawal for the user, only available via HMAC tokens with the withdrawal permission.

HTTP Request

POST https://api.hollaex.com/v2/user/withdrawal

PARAMETERS

Parameter	Type	Required/Optional	Description
currency	string	Required	The desired currency e.g. xht
amount	number	Required	The amount to withdrawal e.g. 5
address	string	Required	The recipient wallet's address
network	string	Optional	Network of currency being withdrawn if there are multiple networks for currency

Get Trades

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/user/trades"

Response

{
    "count": 1,
    "data": [
        {
            "side": "sell",
            "symbol": "xht-usdt",
            "size": 0.1,
            "price": 0.15,
            "timestamp": "2021-02-15T07:34:34.203Z",
            "order_id": "string",
            "fee": 0.2,
            "fee_coin": "usdt"
        }
    ]
}

This endpoint displays user's trades

HTTP Request

GET https://api.hollaex.com/v2/user/trades

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Optional	The currency pair symbol
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data in ISO 8601 format
format	string	Optional	Pass value csv to download csv file

Get All Orders

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/orders"

Response

{
    "count": 1,
    "data": [
        {
            "id": "string",
            "side": "sell",
            "symbol": "xht-usdt",
            "size": 0.1,
            "filled": 0,
            "stop": null,
            "fee": 0,
            "fee_coin": "usdt",
            "type": "limit",
            "price": 1.09,
            "status": "new",
            "created_by": 116,
            "created_at": "2021-02-17T02:32:38.910Z",
            "updated_at": "2021-02-17T02:32:38.910Z",
            "User": {
                "id": 116,
                "email": "fight@club.com",
                "username": "narrator",
                "exchange_id": 176
            }
        }
    ]
}

This endpoint gets all active orders placed by the user

HTTP Request

GET https://api.hollaex.com/v2/orders

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Optional	The currency pair symbol
side	string	Optional	Side of orders to query (buy, sell)
open	boolean	Optional	Open status of order
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data in ISO 8601 format

Get Order

Request

curl -X GET
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/order?$order_id"

Response

{
    "id": "string",
    "side": "sell",
    "symbol": "xht-usdt",
    "size": 0.1,
    "filled": 0,
    "stop": null,
    "fee": 0,
    "fee_coin": "usdt",
    "type": "limit",
    "price": 1.09,
    "status": "new",
    "created_by": 116,
    "created_at": "2021-02-17T02:32:38.910Z",
    "updated_at": "2021-02-17T02:32:38.910Z"
}

This endpoint gets an order by its id.

HTTP Request

GET https://api.hollaex.com/v2/order?order_id=${order_id}

PARAMETERS

Parameter	Type	Required/Optional	Description
order_id	string	Required	Order unique Id

Create Order

Request

curl -X POST
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  -H "Content-Type: application/json"
  -d '{"symbol":$symbol,"side":$side,"size":$size,"type":$type,"price":$price}'
  "https://api.hollaex.com/v2/order"

Response

{
    "fee": 0,
    "meta": {},
    "symbol": "xht-usdt",
    "side": "sell",
    "size": 0.1,
    "type": "limit",
    "price": 1,
    "fee_structure": {
        "maker": 0.2,
        "taker": 0.2
    },
    "fee_coin": "usdt",
    "id": "string",
    "created_by": 116,
    "filled": 0,
    "status": "new",
    "updated_at": "2021-02-17T03:03:19.231Z",
    "created_at": "2021-02-17T03:03:19.231Z",
    "stop": null
}

This endpoint places an order for the user

HTTP Request

POST https://api.hollaex.com/v2/order

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol (xht-usdt)
side	string	Required	buy or sell order
size	number	Required	The amount of the order
type	string	Required	limit or market order type
price	number	Required if limit order	Only should be used when type is limit
stop	number	Optional	Stop price of order
meta	object	Optional	Object with other options
meta.post_only	boolean	Optional	Set to true if order should only be made if market maker
meta.note	string	Optional	Additional note to add to order data

Execute Order

Request

curl -X POST
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  -H "Content-Type: application/json"
  -d '{"token":$token}'
  "https://api.hollaex.com/v2/order/execute"

Response

{
  "symbol": "btc-usdt",
  "side": "sell",
  "size": 0.0001,
  "type": "market",
  "price": 0,
  "fee_structure": { "maker": 0.2, "taker": 0.2 },
  "fee_coin": "usdt",
  "id": "6a70663f-8948-4d08-b1b7-6c81a7b13c16",
  "created_by": 10792,
  "filled": 0.0001,
  "method": "market",
  "created_at": "2023-11-09T21:09:36.060Z",
  "updated_at": "2023-11-09T21:09:36.060Z",
  "average": 34500,
  "status": "filled"
}

This endpoint executes an order for the user

HTTP Request

POST https://api.hollaex.com/v2/order/execute

PARAMETERS

Parameter	Type	Required/Optional	Description
token	string	Required	token

Cancel All Orders

Request

curl -X DELETE
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/order/all?symbol=xht-usdt"

Response

[
    {
        "created_by": 116,
        "side": "sell",
        "type": "limit",
        "size": 0.1,
        "price": 1,
        "created_at": "2021-02-17T03:04:59.607Z",
        "updated_at": "2021-02-17T03:05:02.945Z",
        "symbol": "xht-usdt",
        "filled": 0,
        "stop": null,
        "status": "canceled",
        "fee": 0,
        "fee_coin": "usdt",
        "meta": {},
        "id": "string",
        "fee_structure": {
            "maker": 0.2,
            "taker": 0.2
        }
    },
    ...
]

This endpoint cancels all orders of the same currency pair symbol, placed by the user.

HTTP Request

DELETE https://api.hollaex.com/v2/order/all

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol

Cancel Order

Request

curl -X DELETE
  -H "api-key: $API_KEY"
  -H "api-signature: $API_SIGNATURE"
  -H "api-expires: $API_EXPIRES"
  "https://api.hollaex.com/v2/order?order_id=$order_id"

Response

{
    "created_by": 116,
    "side": "buy",
    "type": "limit",
    "size": 2,
    "price": 1,
    "created_at": "2021-02-17T03:07:36.244Z",
    "updated_at": "2021-02-17T03:07:52.683Z",
    "symbol": "xht-usdt",
    "filled": 0,
    "stop": null,
    "status": "canceled",
    "fee": 0,
    "fee_coin": "xht",
    "meta": {},
    "id": "string",
    "fee_structure": {
        "maker": 0.2,
        "taker": 0.2
    }
}

This endpoint cancels an order by getting its id

HTTP Request

DELETE https://api.hollaex.com/v2/order?order_id=${order_id}

PARAMETERS

Parameter	Type	Required/Optional	Description
order_id	string	Required	Specific order unique Id

TradingView

HollaEx fully supports the TradingView UDF API.

Config

Request

curl -X GET "https://api.hollaex.com/v2/udf/config"

Response

{
    "supported_resolutions": [
        "60",
        "1D"
    ],
    "supports_group_request": false,
    "supports_marks": false,
    "supports_search": true,
    "supports_timescale_marks": false
}

This endpoint retrieves the TradingView UDF config.

HTTP Request

GET https://api.hollaex.com/v2/udf/config

History

Request

curl -X GET "https://api.hollaex.com/v2/udf/history?symbol=xht-usdt&resolution=1D&from=1551663947&to=1582768007"

Response

{
    "c": [...],
    "h": [...],
    "l": [...],
    "o": [...],
    "v": [...],
    "s": "ok"
}

This endpoint retrieves the TradigView UDF history HOLCV.

HTTP Request

GET https://api.hollaex.com/v2/udf/history?symbol=${symbol}&resolution=${resolution}&from=${from}&to=${to}

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol (xht-usdt, etc.)
resolution	string	Required	Time interval resolution (1D, 60, etc.)
from	string	Required	Beginning UNIX timestamp
to	string	Required	Ending UNIX timestamp

Symbols

Request

curl -X GET "https://api.hollaex.com/v2/udf/symbols?symbol=xht-usdt"

Response

{
    "name": "bitHolla",
    "ticker": "xht-usdt",
    "exchange": "HollaEx",
    "has_intraday": true,
    "has_daily": true,
    "has_weekly_and_monthly": true,
    "session": "24x7",
    "regular_session": "24x7",
    "pricescale": 1,
    "volume_precision": 2,
    "has_empty_bars": true
}

This endpoint retrieves system a TradingView UDF symbol.

HTTP Request

GET https://api.hollaex.com/v2/udf/symbols?symbol=${symbol}

PARAMETERS

Parameter	Type	Required/Optional	Description
symbol	string	Required	The currency pair symbol (xht-usdt, etc.)

Admin API

Endpoints only accessible to Admins of Hollaex Kit

getExchangeInfo

Request

curl -X GET "https://api.hollaex.com/v2/admin/exchange"

Response

{
   "id": 781,
    "name": "testexchange429",
    "expiry": "2022-03-30T13:19:06.283Z",
    "url": "localhost",
    "active": true,
    "is_trial": false,
    "created_at": "2022-03-28T13:19:06.284Z",
    "coins": [
        "btc",
        "usdt",
        "eth",
        "xht"
    ],
    "pairs": [
        "btc-usdt",
        "eth-usdt",
        "xht-usdt"
        "eth-btc"
    ],
    "plan": null,
    "period": null
}

Get admin exchange information

HTTP Request

GET https://api.hollaex.com/v2/admin/exchange

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by

getExchangeUserReferrer

Request

curl -X GET "https://api.hollaex.com/v2/admin/user/referer"

Response

{
    "count": 1,
    "data": [
        {
            "referrer": {
                "id": 10,
                "email": "test@mail.com"
            }
        },
    ]
}

Retrieve user's referer info by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/user/referer

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by

deactivateExchangeUserOtp

Request

curl -X POST "https://api.hollaex.com/v2/admin/deactivate-otp"

Response

{
    "message": "Success"
}

Deactivate user otp by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/deactivate-otp

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by

getExchangeUserReferrals

Request

curl -X GET "https://api.hollaex.com/v2/admin/user/affiliation"

Response

{
    "count": 1,
    "data": [
        {
            "referrer_id": 1,
            "user": {
                "id": 10,
                "email": "test@mail.com"
            }
        },
    ]
}

Retrieve user's referrals info by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/user/affiliation

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.

activateExchangeUser

Request

curl -X POST "https://api.hollaex.com/v2/admin/user/activate"

Response

{
   "message": "Success"
}

Activate exchange user account by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/user/activate

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
activated	boolean	Requred	The option to activate or deactivate

getExchangeUserLogins

Request

curl -X GET "https://api.hollaex.com/v2/admin/logins"

Response

{
    "count": 1,
    "data": [
        {
            "ip": "172.19.0.1",
            "device": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36",
            "domain": "http://localhost:3000",
            "timestamp": "2023-04-16T11:24:22.197Z",
            "user_id": 1,
            "UserId": 1
        },
    ]
}

Retrieve user's login info by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/logins

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.

createExchangeUserBank

Request

curl -X POST "https://api.hollaex.com/v2/admin/user/bank"

Response

{
   "message": "Success"
}

Create bank account for user by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/user/bank

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
bank_account	object	Required	Array of objects with bank account info

getExchangeUserBalance

Request

curl -X GET "https://api.hollaex.com/v2/admin/user/balance"

Response

{
    "user_id": 1,
    "btc_balance": 0.4972535,
    "btc_available": 0.4972535,
    "usdt_balance": 38860.29955,
    "usdt_available": 38857.29955,
    "eth_balance": 0,
    "eth_available": 0,
    "xht_balance": 877.046264
}

Retrieve user's balance by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/user/balance

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by

getExchangeUserWallet

Request

curl -X GET "https://api.hollaex.com/v2/admin/user/wallet"

Response

{
    "count": 1,
    "data": [
        {
            "currency": "btc",
            "address": "31j36fxNCt51mtMd15DMF9UyEb5YmGx3bZ",
            "network": "btc",
            "standard": null,
            "is_valid": true,
            "created_at": "2023-03-31T01:08:40.987Z",
            "updated_at": "2023-03-31T01:08:40.987Z",
            "User": {
                "email": "testmail12@gmail.com",
                "exchange_id": 781
            },
            "network_id": 10509
        },
    ]
}

Retrieve users' wallets by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/user/wallet

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.
address	string	Optional	Address of crypto
is_valid	boolean	Optional	Specify whether or not wallet is valid
network	string	Optional	Crypto network of currency
format	string	Optional	Custom format of data set. Enum: ['all', 'csv']

createExchangeUserWallet

Request

curl -X POST "https://api.hollaex.com/v2/admin/user/wallet"

Response

{
   "message": "Success"
}

Create wallet for exchange user

HTTP Request

POST https://api.hollaex.com/v2/admin/user/wallet

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
crypto	number	Required	The coin for the wallet e.g btc, eth
network	number	Optional	The network info

createExchangeUser

Request

curl -X POST "https://api.hollaex.com/v2/admin/user"

Response

{
   "message": "Success"
}

Create exchange user

HTTP Request

POST https://api.hollaex.com/v2/admin/user

PARAMETERS

Parameter	Type	Required/Optional	Description
email	string	Required	The mail address for the user
password	string	Required	The password for the user

updateExchangeUser(role)

Request

curl -X PUT "https://api.hollaex.com/v2/admin/user/role"

Response

{
   "message": "Success"
}

Update exchange user role

HTTP Request

PUT https://api.hollaex.com/v2/admin/user/role

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
role	string	Required	The role of the user

updateExchangeUser(meta)

Request

curl -X PUT "https://api.hollaex.com/v2/admin/user/meta"

Response

{
   "message": "Success"
}

Update exchange user meta

HTTP Request

PUT https://api.hollaex.com/v2/admin/user/meta

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
meta	object	Required	The meta object of the user
overwrite	boolean	Optional	The overwrite field

updateExchangeUser(discount)

Request

curl -X PUT "https://api.hollaex.com/v2/admin/user/discount"

Response

{
   "message": "Success"
}

Update exchange user discount

HTTP Request

PUT https://api.hollaex.com/v2/admin/user/discount

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
discount	number	Required	The discount number of the user

updateExchangeUser(note)

Request

curl -X PUT "https://api.hollaex.com/v2/admin/user/note"

Response

{
   "message": "Success"
}

Update exchange user note

HTTP Request

PUT https://api.hollaex.com/v2/admin/user/note

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
note	string	Required	The note text of the user

updateExchangeUser(verification level)

Request

curl -X POST "https://api.hollaex.com/v2/admin/upgrade-user"

Response

{
   "message": "Success"
}

Update exchange user verification level

HTTP Request

POST https://api.hollaex.com/v2/admin/upgrade-user

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
verification_level	number	Required	The verification_level of the user

getExchangeUsers

Request

curl -X GET "https://api.hollaex.com/v2/admin/users"

Response

{
   "count": 1,
    "data": [
        {
            "id": 346,
            "email": "23423f4@gmail.com",
            "full_name": "",
            "gender": false,
            "nationality": "",
            "dob": null,
            "phone_number": "",
            "address": {
                "city": "",
                "address": "",
                "country": "",
                "postal_code": ""
            },
            "id_data": {
                "note": "",
                "type": "",
                "number": "",
                "status": 0,
                "issued_date": "",
                "expiration_date": ""
            },
            "bank_account": [],
            "crypto_wallet": {},
            "verification_level": 1,
            "email_verified": true,
            "otp_enabled": false,
            "activated": true,
            "note": "",
            "username": "23423f4",
            "affiliation_code": "1RSWRK",
            "settings": {
                "chat": {
                    "set_username": false
                },
                "risk": {
                    "order_portfolio_percentage": 90
                },
                "audio": {
                    "public_trade": false,
                    "order_completed": true,
                    "order_partially_completed": true
                },
                "language": "en",
                "interface": {
                    "theme": "dark",
                    "order_book_levels": 10
                },
                "notification": {
                    "popup_order_completed": true,
                    "popup_order_confirmation": true,
                    "popup_order_partially_filled": true
                }
            },
            "flagged": false,
            "affiliation_rate": 0,
            "network_id": 11262,
            "discount": 0,
            "meta": {},
            "created_at": "2023-04-10T20:44:34.717Z",
            "updated_at": "2023-04-10T20:44:35.799Z"
        },
    ]
}

Retrieve list of the user info by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/users

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.
search	string	Optional	The search text to filter by, pass undefined to receive data on all fields
pending	boolean	Optional	The pending field to filter by, pass undefined to receive all data
pending_type	string	Optional	The pending type info to filter by, pass undefined to receive data
format	string	Optional	Custom format of data set. Enum: ['all', 'csv']

createExchangeUserOrder

Request

curl -X POST "https://api.hollaex.com/v2/admin/order"

Response

{
  "fee": 0,
  "meta": {},
  "symbol": "xht-usdt",
  "side": "buy",
  "size": 1,
  "type": "limit",
  "price": 0.1,
  "fee_structure": { "maker": 0.186, "taker": 0.186 },
  "fee_coin": "xht",
  "id": "a80b5c7f-be88-4d24-b134-cfb7b31b6d7d",
  "created_by": 10792,
  "filled": 0,
  "filled": 0,
  "average": 0.1,
  "status": "new",
  "updated_at": "2023-12-12T23:51:22.239Z",
  "created_at": "2023-12-12T23:51:22.239Z",
  "stop": null
}

Create order on behalf of user

HTTP Request

POST https://api.hollaex.com/v2/admin/order

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	User id for the order
symbol	string	Required	Currency symbol of the order e.g. xht-usdt
size number	Required	Amount of the order
price	number	Required	Order Price
side	string	Required	Order Side, buy or sell
type	string	Required	Order Type, limit or market

cancelExchangeUserOrder

Request

curl -X DELETE "https://api.hollaex.com/v2/admin/order"

Response

{
   "message": "Success"
}

Cancel user's order by order id

HTTP Request

DELETE https://api.hollaex.com/v2/admin/order

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by

getExchangeOrders

Request

curl -X GET "https://api.hollaex.com/v2/admin/orders"

Response

{
   "count": 1,
    "data": [
        {
            "id": "21c2be80-a2d8-4797-9ed9-caf83c631586",
            "side": "buy",
            "symbol": "xht-usdt",
            "size": 10,
            "filled": 0,
            "stop": null,
            "fee": 0,
            "fee_coin": "xht",
            "type": "limit",
            "price": 0.3,
            "status": "new",
            "created_by": 1,
            "created_at": "2023-04-10T21:48:13.691Z",
            "updated_at": "2023-04-10T21:48:13.691Z",
            "meta": {},
            "average": 0.3,
            "User": {
                "id": 1,
                "email": "test15@mail.com_m3cc4",
                "username": "test15",
                "exchange_id": 781
            },
            "network_id": 10792
        },
    ]
}

Retrieve user's orders by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/orders

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
side	string	Optional	The order side (buy or side)
status	string	Optional	The order's status e.g open, filled, canceled etc
open	boolean	Optional	The info on whether the order is active or not
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.
format	string	Optional	Custom format of data set. Enum: ['all', 'csv']

getExchangeTrades

Request

curl -X GET "https://api.hollaex.com/v2/admin/trades"

Response

{
   "count": 1,
    "data": [
        {
            "side": "buy",
            "symbol": "xht-usdt",
            "size": 1,
            "price": 0.35,
            "maker_order_id": null,
            "taker_order_id": "c3a29aa8-0e8a-40f7-9057-a873dba65402",
            "timestamp": "2023-03-09T20:09:33.379Z",
            "maker_fee": null,
            "taker_fee": 0.002,
            "maker_fee_coin": null,
            "taker_fee_coin": "xht",
            "quick": false,
            "maker_id": null,
            "taker_id": 1,
            "taker_network_id": 10792
        },
    ]
}

Retrieve user's trades by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/trades

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
limit	number	Optional	Amount of referrals per page. Maximum: 50. Default: 50
side	string	Optional	The order side (buy or side)
symbol	string	Optional	The symbol-pair to filter by, pass undefined to receive data on all currencies
page	number	Optional	Page of referral data. Default: 1
order_by	string	Optional	The field to order data by e.g. amount, id.
order	string	Optional	Ascending (asc) or descending (desc).
start_date	date	Optional	Start date of query in ISO8601 format.
end_date	date	Optional	End date of query in ISO8601 format.
format	string	Optional	Custom format of data set. Enum: ['all', 'csv']

settleExchangeFees

Request

curl -X GET "https://api.hollaex.com/v2/admin/fees/settle"

Response

{
    "message": "Success"
}

Set exchange fees by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/fees/settle

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by

checkExchangeDepositStatus

Request

curl -X GET "https://api.hollaex.com/v2/admin/check-transaction"

Response

{

}

Check exchange deposit status

HTTP Request

GET https://api.hollaex.com/v2/admin/check-transaction

PARAMETERS

Parameter	Type	Required/Optional	Description
currency	string	Required	The currency to filter by, pass undefined to receive data on all currencies
transaction_id	string	Required	Deposits with specific transaction ID.
address	string	Required	Deposits with specific address.
network	string	Required	The network info
is_testnet	boolean	Optional	The info on whether it's a testnet or not

updateExchangeWithdrawal

Request

curl -X PUT "https://api.hollaex.com/v2/admin/burn"

Response

{
   "message": "Success"
}

Update Exchange Withdrawal

HTTP Request

PUT https://api.hollaex.com/v2/admin/burn

PARAMETERS

Parameter	Type	Required/Optional	Description
transaction_id	string	Required	Withdrawals with specific transaction ID.
updated_transactionId	string	Optional	Withdrawals with updated transaction id
updated_address	string	Optional	Withdrawals with updated address
status	boolean	Optional	Confirmed status of the withdrawals to set.
dismissed	boolean	Optional	Dismissed status of the withdrawals to set.
rejected	boolean	Optional	Rejected status of the withdrawals to set.
processing	boolean	Optional	Processing status of the withdrawals to set.
waiting	boolean	Optional	Waiting status of the withdrawals to set.
email	boolean	Optional	Email
description	string	Optional	The description field

createExchangeWithdrawal

Request

curl -X POST "https://api.hollaex.com/v2/admin/burn"

Response

{
   "message": "Success"
}

Create exchange withdrawal by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/burn

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
currency	string	Required	The currency to specify
amount	number	Required	The amount to specify
transaction_id	string	Optional	Withdrawal with specific transaction ID.
status	boolean	Optional	The status field to confirm the withdrawal
email	boolean	Optional	The email field
fee	number	Optional	The fee to specify

updateExchangeDeposit

Request

curl -X PUT "https://api.hollaex.com/v2/admin/mint"

Response

{
   "message": "Success"
}

Update exchange deposit by admin

HTTP Request

PUT https://api.hollaex.com/v2/admin/mint

PARAMETERS

Parameter	Type	Required/Optional	Description
transaction_id	string	Required	Withdrawals with specific transaction ID.
updated_transactionId	string	Optional	Withdrawals with updated transaction id
updated_address	string	Optional	Withdrawals with updated address
status	boolean	Optional	Confirmed status of the withdrawals to set.
dismissed	boolean	Optional	Dismissed status of the withdrawals to set.
rejected	boolean	Optional	Rejected status of the withdrawals to set.
processing	boolean	Optional	Processing status of the withdrawals to set.
waiting	boolean	Optional	Waiting status of the withdrawals to set.
email	boolean	Optional	Email
description	string	Optional	The description field

createExchangeDeposit

Request

curl -X POST "https://api.hollaex.com/v2/admin/mint"

Response

{
   "message": "Success"
}

Create exchange deposit by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/mint

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user to filter by
currency	string	Required	The currency to specify
amount	number	Required	The amount to specify
transaction_id	string	Optional	Withdrawal with specific transaction ID.
status	boolean	Optional	The status field to confirm the withdrawal
email	boolean	Optional	The email field
fee	number	Optional	The fee to specify

transferExchangeAsset

Request

curl -X POST "https://api.hollaex.com/v2/admin/transfer"

Response

{
   "message": "Success"
}

Transfer exchange asset by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/transfer

PARAMETERS

Parameter	Type	Required/Optional	Description
sender_id	number	Required	The identifier of the sender
receiver_id	number	Required	The identifier of the receiver
currency	string	Required	The currency to specify
amount	number	Required	The amount to specify
description	string	Optional	The description field
email	boolean	Optional	The email field

getExchangeBalance

Request

curl -X GET "https://api.hollaex.com/v2/admin/balance"

Response

{
    "btc_balance": 0.50727102,
    "btc_available": 0.50727102,
    "usdt_balance": 40030.93636929621,
    "usdt_available": 40026.73636929621,
    "eth_balance": 0.0001996,
    "eth_available": 0.0001996,
    "xht_balance": 1166.2836345,
    "xht_available": 1166.2836345,
    "try_balance": 0,
    "try_available": 0
}

Retrieve admin's wallet balance

HTTP Request

GET https://api.hollaex.com/v2/admin/balance

PARAMETERS

Parameter	Type	Required/Optional	Description

getExchangeWithdrawals

Request

curl -X GET "https://api.hollaex.com/v2/admin/withdrawals"

Response

{
   "count": 1,
    "data": [
        {
            "id": 11103,
            "amount": 5,
            "fee": 0,
            "address": "transfer",
            "transaction_id": "0200a457-1965-45de-ac08-03699d44c7f6",
            "status": true,
            "dismissed": false,
            "rejected": false,
            "processing": false,
            "waiting": false,
            "description": "Admin Transfer",
            "type": "withdrawal",
            "currency": "usdt",
            "network": null,
            "fee_coin": "usdt",
            "created_at": "2023-04-16T20:49:01.228Z",
            "updated_at": "2023-04-16T20:49:01.228Z",
            "user_id": 1,
            "User": {
                "email": "test15@mail.com_m3cc4",
                "exchange_id": 781,
                "Exchange": {
                    "id": 781,
                    "name": "testexchange429",
                    "display_name": "test-exchange429"
                },
                "id": 1
            },
            "network_id": 10792
        },
    ]
}

Retrieve list of the user's withdrawals by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/withdrawals

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
currency	string	Optional	The currency pair symbol
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
transaction_id	string	Optional	Get deposits with this transaction ID
address	string	Optional	Get deposits made to this address
status	boolean	Optional	Completed status of deposits to get
dismissed	boolean	Optional	Dismissed status of deposits to get
rejected	boolean	Optional	Rejected status of deposits to get
processing	boolean	Optional	Processing status of deposits to get
waiting	boolean	Optional	Waiting status of deposits to get
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data in ISO 8601 format
format	string	Optional	Pass value csv to download csv file

getExchangeWithdrawals

Request

curl -X GET "https://api.hollaex.com/v2/admin/deposits"

Response

{

   {
    "count": 1,
    "data": [
        {
            "id": 11104,
            "amount": 5,
            "fee": 0,
            "address": "transfer",
            "transaction_id": "0200a457-1965-45de-ac08-03699d44c7f6",
            "status": true,
            "dismissed": false,
            "rejected": false,
            "processing": false,
            "waiting": false,
            "description": "Admin Transfer",
            "type": "deposit",
            "currency": "usdt",
            "network": null,
            "fee_coin": "usdt",
            "created_at": "2023-04-16T20:49:01.228Z",
            "updated_at": "2023-04-16T20:49:01.228Z",
            "user_id": 10,
            "User": {
                "email": "test_auth9126@mail.com_vow05",
                "exchange_id": 781,
                "Exchange": {
                    "id": 781,
                    "name": "testexchange429",
                    "display_name": "test-exchange429"
                },
                "id": 10
            },
            "network_id": 10871
        },
    ]
   }
}

Retrieve list of the user's deposits by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/deposits

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user to filter by
currency	string	Optional	The currency pair symbol
limit	number	Optional	Number of elements to return. Default: 50. Maximun: 100
page	number	Optional	Page of data to retrieve
order_by	string	Optional	Field to order data
order	string	Optional	asc or desc
transaction_id	string	Optional	Get deposits with this transaction ID
address	string	Optional	Get deposits made to this address
status	boolean	Optional	Completed status of deposits to get
dismissed	boolean	Optional	Dismissed status of deposits to get
rejected	boolean	Optional	Rejected status of deposits to get
processing	boolean	Optional	Processing status of deposits to get
waiting	boolean	Optional	Waiting status of deposits to get
start_date	date-time	Optional	Starting date of queried data in ISO 8601 format
end_date	date-time	Optional	Ending date of queried data in ISO 8601 format
format	string	Optional	Pass value csv to download csv file

sendExchangeUserEmail

Request

curl -X POST "https://api.hollaex.com/v2/admin/send-email"

Response

{
   "message": "Success"
}

Send email to exchange user account by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/send-email

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Required	The identifier of the user
mail_type	string	Required	The mail type for the email payload
data	object	Required	The content of the mail

sendRawEmail

Request

curl -X POST "https://api.hollaex.com/v2/admin/send-email/raw"

Response

{
   "message": "Success"
}

Send email to users with custom html by admin

HTTP Request

POST https://api.hollaex.com/v2/admin/send-email/raw

PARAMETERS

Parameter	Type	Required/Optional	Description
receivers	array	Required	The array of emails to send mail
html	string	Required	The stringified html content
title	string	Optional	The title of the mail
text	string	Optional	The text of the mail

getExchangeUserBalances

Request

curl -X GET "https://api.hollaex.com/v2/admin/balances"

Response

{
   "count": 356,
   "data": [
    {
      "balance": "2.0010000000000000",
      "available": "2.0010000000000000",
      "symbol": "xht",
      "updated_at": "2022-02-17T08:27:10.637Z",
      "user_id": 150,
      "network_id": 582
    },
    {
      "balance": "2.0110000000000000",
      "available": "2.0110000000000000",
      "symbol": "xht",
      "updated_at": "2022-02-17T09:07:46.303Z",
      "user_id": 33,
      "network_id": 324
    },
    {
      "balance": "49108.1478000000000000",
      "available": "49108.1478000000000000",
      "symbol": "xht",
      "updated_at": "2023-02-21T18:37:58.966Z",
      "user_id": 8,
      "network_id": 138
    },
    {
      "balance": "2.1000000000000000",
      "available": "2.1000000000000000",
      "symbol": "xht",
      "updated_at": "2023-05-22T12:07:39.124Z",
      "user_id": 11,
      "network_id": 188
    },
    {
      "balance": "5.0000000000000000",
      "available": "5.0000000000000000",
      "symbol": "xht",
      "updated_at": "2023-07-03T14:22:28.277Z",
      "user_id": 1664,
      "network_id": 12392
    },
    {
      "balance": "1.0000000000000000",
      "available": "1.0000000000000000",
      "symbol": "xht",
      "updated_at": "2022-02-17T08:25:37.498Z",
      "user_id": 136,
      "network_id": 568
    },

    ...
   ]
}

Retrieve users balances by admin

HTTP Request

GET https://api.hollaex.com/v2/admin/balances

PARAMETERS

Parameter	Type	Required/Optional	Description
user_id	number	Optional	The identifier of the user
currency	string	Optional	The currency pair symbol (xht-usdt, etc.)
format	string	Optional	Pass value 'all' to download csv file

Websocket

Connection to public and private channels are available through the path https://api.hollaex.com/stream. HollaEx Exchanges can be connected to using any websocket libraries. For this documentation, we will use the library ws.

Connecting

Connection


    const WebSocket = require('ws');

    // Public
    const client = new WebSocket('wss://api.hollaex.com/stream');

    // Private HMAC
    const client = new WebSocket(`wss://api.hollaex.com/stream?api-key=${API-KEY}&api-signature=${API-SIGNATURE}&api-expires=${API-EXPIRES}`);

    client.on('open', () => {
        // Ping message to keep connection alive
        setInterval(() => {
            client.send(
                JSON.stringify({
                    op: 'ping'
                })
            )
        })
    }, 30000);

Connection for public events does not require authentication while private events do. Users can use Bearer or HMAC authentication. For HMAC, the method is CONNECT and the path is /stream. Refer to the Authentication section for more information on HMAC-SHA256.

Websocket connections will disconnect if a message is not sent within one minute. To keep a connection alive, you can sent a ping message every ~30 seconds.

PATH

wss://api.hollaex.com/stream

PARAMETERS

Parameter	Type	Required/Optional	Description
api-key (HMAC)	string	Optional	Your exchange api-key
api-signature (HMAC)	string	Optional	An api-signature created using HMAC SHA256
api-expires (HMAC)	string	Optional	Expiry time of request

Sending/Receiving Messages

Connection


    client.send(
        JSON.stringify({
            op: OPERATION,
            args: [EVENTS]
        })
    );

    client.on('message', (data) => {
        data = JSON.parse(data);
        console.log(data);
    })

Operations

Operation	Description
subscribe	Subscribe to events.
unsubscribe	Unsubscribe to events.
ping	Ping-pong message for keeping connections alive.

Events

Events	Description
orderbook	Public event for orderbook updates.
trade	Public event for trade updates.
order	Private event for user order updates.
usertrade	Private event for user trades.
wallet	Private even for wallet balance updates.
deposit	Private event for user deposits.
withdrawal	Private event for user withdrawals.
admin	Private event for exchange admin only.

Public Events

Connection


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

        // Subscribe
        client.send(
            JSON.stringify({
                op: 'subscribe',
                args: ['orderbook', 'trades']
            })
        );

        // On message
        client.on('message', (data) => {
            console.log(JSON.parse(data));
        });

        // Unsubscribe
        client.send(
            JSON.stringify({
                op: 'unsubscribe',
                args: ['orderbook', 'trade']
            })
        );
    })

EVENTS

The public events you can subscribe to are:

Event	Description
orderbook	Notification with orderbook symbol and data update. To subscribe to a specific pair, you can pass the pair after a colon. Ex: `orderbook:xht-usdt`.
trade	Notification with trade data. To subscribe to a specific pair, you can pass the pair after a colon. Ex: `trade:xht-usdt`.

Public Updates

orderbook


{
    "topic": "orderbook",
    "action": "partial",
    "symbol": "xht-usdt",
    "data": {
        "bids": [
            [0.1, 0.1],
            ...
        ],
        "asks": [
            [1, 1],
            ...
        ],
        "timestamp": "2020-12-15T06:45:27.766Z"
    },
    "time": 1608015328
}

trades


{
    "topic": "trade",
    "action": "partial",
    "symbol": "xht-usdt",
    "data": [
        {
            "size": 0.012,
            "price": 300,
            "side": "buy",
            "timestamp": "2020-12-15T07:25:28.887Z"
        },
        ...
    ],
    "time": 1608015328
}

Private Events

Connection


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

        // Subscribe
        client.send(
            JSON.stringify({
                op: 'subscribe',
                args: ['order', 'wallet']
            })
        );

        // On message
        client.on('message', (data) => {
            console.log(JSON.parse(data));
        });

        // Unsubscribe
        client.send(
            JSON.stringify({
                op: 'unsubscribe',
                args: ['order', 'wallet']
            })
        );
    })

EVENTS

The private events you can subscribe to are:

Event	Description
order	Notifications for newly created orders and order updates.
wallet	Notifications for balance updates.

Private Updates

order


{
    "topic": "order",
    "action": "partial",
    "user_id": 1,
    "data": [
        {
            "id": "7d3d9545-b7e6-4e7f-84a0-a39efa4cb173",
            "side": "buy",
            "symbol": "xht-usdt",
            "type": "limit",
            "size": 0.1,
            "filled": 0,
            "price": 1,
            "stop": null,
            "status": "new",
            "fee": 0,
            "fee_coin": "xht",
            "meta": {},
            "fee_structure": {
                "maker": 0.1,
                "taker": 0.1
            },
            "created_at": "2020-11-30T07:45:43.819Z",
            "created_by": 1
        },
        ...
    ],
    "time": 1608022610
}

{
    "topic": "order",
    "action": "insert",
    "user_id": 1,
    "symbol": "xht-usdt",
    "data": [
        {
            "id": "7d3d9545-b7e6-4e7f-84a0-a39efa4cb173",
            "side": "buy",
            "symbol": "xht-usdt",
            "type": "limit",
            "size": 0.1,
            "filled": 0,
            "price": 1,
            "stop": null,
            "status": "new",
            "fee": 0,
            "fee_coin": "xht",
            "meta": {},
            "fee_structure": {
                "maker": 0.1,
                "taker": 0.1
            },
            "created_at": "2020-11-30T07:45:43.819Z",
            "updated_at": "2020-12-15T08:56:45.066Z",
            "created_by": 1
        },
        ...
    ],
    "time": 1608022610
}

{
    "topic": "order",
    "action": "insert",
    "user_id": 1,
    "symbol": "xht-usdt",
    "data": [
        {
            "id": "7d3d9545-b7e6-4e7f-84a0-a39efa4cb173",
            "side": "buy",
            "symbol": "xht-usdt",
            "type": "limit",
            "size": 0.1,
            "filled": 0,
            "price": 1,
            "stop": null,
            "status": "new",
            "fee": 0,
            "fee_coin": "xht",
            "meta": {},
            "fee_structure": {
                "maker": 0.1,
                "taker": 0.1
            },
            "created_at": "2020-11-30T07:45:43.819Z",
            "updated_at": "2020-12-15T08:56:45.066Z",
            "created_by": 1
        },
        ...
    ],
    "time": 1608022610
}

Order status and action

The status of the order can be new, pfilled, filled, and canceled.

The action of the data determines what caused it to happen. All three are explained below:

Action	Description
partial	All previous and current orders. Is the first order data received when connecting. Max: 50. Descending order.
insert	When user's order is added. The status of the order can be either new, pfilled, or filled.
update	When user's order status is updated. Status can be pfilled, filled, and canceled.

wallet


{
    "topic": "wallet",
    "action": "partial",
    "user_id": 1,
    "data": {
        "usdt_balance": 1,
        "usdt_available": 1,
        "xht_balance": 1,
        "xht_available": 1,
        "xmr_balance": 1,
        "xmr_available": 1,
        "btc_balance": 1,
        "btc_available": 1,
        "eth_balance": 1,
        "eth_available": 1,
        ...,
        "updated_at": "2020-12-15T08:41:24.048Z"
    },
    "time": 1608021684
}

Errors

The HollaEx API uses the following error codes:

Error Code	Meaning
400	Bad Request -- Your request is invalid.
401	Unauthorized -- Access denied. Authorization failed
403	Forbidden -- Your API key is not permitted.
404	Not Found -- The endpoint could not be found.
405	Method Not Allowed -- The method for the endpoint does not exist.
429	Too Many Requests -- You're making too many requests, Try again later.
500	Internal Server Error -- We had a problem with our server. Try again later.