Public Endpoints

Health

Request

curl -X GET "https://<your-api-domain>/v2/health"

Response

{
    "name": "HollaEx",
    "version": "2.1.0",
    "host": "https://<your-api-domain>",
    "basePath": "/v2"
}

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

HTTP Request

GET https://<your-api-domain>/v2/health

Constants

Request

curl -X GET "https://<your-api-domain>/v2/constants"

Response

{
    "coins": {
        "btc": {
            "id": 1,
            "fullname": "Bitcoin",
            "symbol": "btc",
            "active": true,
            "verified": true,
            "allow_deposit": true,
            "allow_withdrawal": true,
            "withdrawal_fee": 0.0005,
            "min": 0.0001,
            "max": 100000,
            "increment_unit": 0.00001,
            "created_at": "2019-08-09T10:45:43.367Z",
            "updated_at": "2019-10-31T05:08:18.907Z",
            "logo": "",
            "code": "btc",
            "is_public": true,
            "meta": {},
            "estimated_price": null,
            "description": null,
            "type": "blockchain",
            "network": "btc",
            "standard": null,
            "issuer": "HollaEx",
            "withdrawal_fees": null,
            "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": "",
            "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": {
        "btc-usdt": {
            "id": 1,
            "name": "btc-usdt",
            "pair_base": "btc",
            "pair_2": "usdt",
            "min_size": 0.0001,
            "max_size": 100,
            "min_price": 1,
            "max_price": 1000000,
            "increment_size": 0.0001,
            "increment_price": 1,
            "active": true,
            "verified": true,
            "code": "btc-usdt",
            "is_public": true,
            "estimated_price": 60000,
            "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://<your-api-domain>/v2/constants

Kit

Request

curl -X GET "https://<your-api-domain>/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": "",
    "description": "HollaEx is a crypto exchange whitelabel",
    "injected_html": {...},
    "injected_values": [...],
    "native_currency": "usdt",
    "setup_completed": true,
    "valid_languages": "en,ko,ar,pt,ja,ru,fr",
    "new_user_is_activated": true,
	"email_verification_required": true,
    "info": {
        "name": "HollaEx",
        "active": true,
        "url": "https://<your-api-domain>",
        "is_trial": false,
        "created_at": "2020-10-05T06:46:27.272Z",
        "expiry": "2021-02-04T06:46:27.000Z",
        "collateral_level": "member",
        "type": "Cloud",
        "plan": "...",
        "period": "year",
        "status": true,
        "initialized": true
    }
}

This endpoint retrieves system kit configurations for the client.

HTTP Request

GET https://<your-api-domain>/v2/kit

Tiers

Request

curl -X GET "https://<your-api-domain>/v2/tiers"

Response

{
    "1": {
        "id": 1,
        "name": "Base Trader",
        "icon": "",
        "description": "basic tier",
        "deposit_limit": 0,
        "withdrawal_limit": 0,
        "fees": {
            "maker": {
                "xmr-usdt": 0.2,
                "eth-usdt": 0.2,
                "btc-usdt": 0.2,
                "eth-btc": 0.2
            },
            "taker": {
                "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": {
                "xmr-usdt": 0,
                "eth-usdt": 0,
                "btc-usdt": 0,
                "eth-btc": 0
            },
            "taker": {
                "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://<your-api-domain>/v2/tiers

Ticker

Request

curl -X GET "https://<your-api-domain>/v2/ticker?symbol=btc-usdt"

Response

{
    "open": 60250,
    "close": 60500,
    "high": 60800,
    "low": 60100,
    "last": 60500,
    "volume": 12.53,
    "timestamp": "2021-04-28T03:05:24.996Z"
}

This endpoint retrieves ticker information for a pair.

HTTP Request

GET https://<your-api-domain>/v2/ticker?symbol=${symbol}

PARAMETERS

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

Tickers

Request

curl -X GET "https://<your-api-domain>/v2/tickers"

Response

{
    "btc-usdt": {
        "time": "2021-04-27T03:05:41.012Z",
        "open": 60250,
        "close": 60500,
        "high": 60800,
        "low": 60100,
        "last": 60500,
        "volume": 12.53,
        "symbol": "btc-usdt"
    },
    ...
}

This endpoint retrieves ticker information for all pairs.

HTTP Request

GET https://<your-api-domain>/v2/tickers

Orderbook

Request

curl -X GET "https://<your-api-domain>/v2/orderbook?symbol=btc-usdt"

Response

{
	"btc-usdt": {
		"bids": [
			[60490,0.05],
			[60480,0.12],
			[60470,0.3],
			[60450,0.25],
			[60400,1.1]
		],
		"asks": [
			[60510,0.08],
			[60520,0.4],
			[60550,0.75]
		],
		"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://<your-api-domain>/v2/orderbook?symbol=${symbol}

PARAMETERS

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

Orderbooks

Request

curl -X GET "https://<your-api-domain>/v2/orderbooks"

Response

{
	"btc-usdt": {
		"bids": [...],
		"asks": [...],
		"timestamp": "2018-03-02T21:36:29.395Z"
	},
	"eth-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://<your-api-domain>/v2/orderbooks

Trades

Request

curl -X GET "https://<your-api-domain>/v2/trades?symbol=btc-usdt"

Response

{
    "btc-usdt": [
        {
            "size": 0.01,
            "price": 60500,
            "side": "buy",
            "timestamp": "2018-03-23T04:00:20.744Z"
        },
        {
            "size": 0.005,
            "price": 60480,
            "side": "buy",
            "timestamp": "2018-03-23T03:32:38.927Z"
        },
        {
            "size": 0.02,
            "price": 60510,
            "side": "sell",
            "timestamp": "2018-03-23T03:13:42.361Z"
        }
    ],
    ...
}

This endpoint retrieves the last 30 trades.

HTTP Request

GET https://<your-api-domain>/v2/trades

PARAMETERS

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

Chart

Request

curl -X GET "https://<your-api-domain>/v2/chart?symbol=btc-usdt&resolution=1D&from=1616987453&to=1619579513"

Response

[
	{
        "time": "2021-04-14T00:00:00.000Z",
        "close": 60500,
        "high": 61000,
        "low": 59800,
        "open": 60100,
        "symbol": "btc-usdt",
        "volume": 20.42
    },
    {
        "time": "2021-04-19T00:00:00.000Z",
        "close": 61200,
        "high": 61500,
        "low": 60300,
        "open": 60500,
        "symbol": "btc-usdt",
        "volume": 43.78
    },
	...
]

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

HTTP Request

GET https://<your-api-domain>/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://<your-api-domain>/v2/charts?resolution=1D&from=1551663947&to=1582768007"

Response

{
    "btc-usdt": [
        {
			"time": "2020-01-01T00:00:00.000Z",
			"close": 60100,
			"high": 60800,
			"low": 59900,
			"open": 60500,
			"symbol": "btc-usdt",
			"volume": 13.53
		},
		{
			"time": "2020-01-02T00:00:00.000Z",
			"close": 60300,
			"high": 60400,
			"low": 60000,
			"open": 60100,
			"symbol": "btc-usdt",
			"volume": 0.54
		},
		{
			"time": "2020-01-03T00:00:00.000Z",
			"close": 60700,
			"high": 60900,
			"low": 60200,
			"open": 60300,
			"symbol": "btc-usdt",
			"volume": 25.98
		},
		...
    ],
    "eth-usdt": [...],
	...
}

This endpoint retrieves trade history HOLCV for all pairs.

HTTP Request

GET https://<your-api-domain>/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://<your-api-domain>/v2/minicharts?assets=btc,eth&quote=usdt"

Response

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

Get trade history HOLCV for all pairs

HTTP Request

GET https://<your-api-domain>/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://<your-api-domain>/v2/oracle/prices?&assets=btc&quote=usdt&amount=1"

Response

{ "btc": 60500 }

Retrieve price conversion

HTTP Request

GET https://<your-api-domain>/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

Health​

HTTP Request​

Constants​

HTTP Request​

Kit​

HTTP Request​

Tiers​

HTTP Request​

Ticker​

HTTP Request​

PARAMETERS​

Tickers​

HTTP Request​

Orderbook​

HTTP Request​

PARAMETERS​

Orderbooks​

HTTP Request​

Trades​

HTTP Request​

PARAMETERS​

Chart​

HTTP Request​

PARAMETERS​

Charts​

HTTP Request​

PARAMETERS​

MiniCharts​

HTTP Request​

PARAMETERS​

Oracle Prices​

HTTP Request​

PARAMETERS​

Health

HTTP Request

Constants

HTTP Request

Kit

HTTP Request

Tiers

HTTP Request

Ticker

HTTP Request

PARAMETERS

Tickers

HTTP Request

Orderbook

HTTP Request

PARAMETERS

Orderbooks

HTTP Request

Trades

HTTP Request

PARAMETERS

Chart

HTTP Request

PARAMETERS

Charts

HTTP Request

PARAMETERS

MiniCharts

HTTP Request

PARAMETERS

Oracle Prices

HTTP Request

PARAMETERS