Pairs List

This method returns the list of all public pairs available on EarnBIT Exchange.

Details

GET https://api.earnbit.com/api/v1/public/markets

CURL Example

curl -X GET "https://api.earnbit.com/api/v1/public/markets" -H "accept: application/json"

Response parameters:

Name

Type

Description

name

STRING

Pair name

moneyPrec

NUMERIC

Precision of money currency

stock

STRING

Ticker of stock currency

money

STRING

Ticker of money currency

stockPrec

NUMERIC

Precision of stock currency

feePrec

NUMERIC

Precision of fee

minAmount

NUMERIC

Minimal amount of stock to trade

Response example:

{
    "code": 200,
    "success": true,
    "message": "",
    "result": [
        {
            "name": "SSV_USDT",
            "moneyPrec": 8,
            "stock": "SSV",
            "money": "USDT",
            "stockPrec": 8,
            "feePrec": 8,
            "minAmount": "0.001"
        },
        ...
  ]
}

Response example:

<html>

<head>
	<title>400 Bad Request</title>
</head>

<body>
	<center>
		<h1>400 Bad Request</h1>
	</center>
	<hr>
	<center>nginx</center>
</body>

</html>

This error occurs in the following cases:

Invalid URL
Request contains invalid headers

Response example:

{
    "timestamp": 1660766043722,
    "status": 404,
    "error": "Not Found",
    "message": "",
    "path": "/api/v1/public/markets-test"
}

This error occurs in the following cases:

The requested URL was not found

With Authentication

This public endpoint can also be used as a POST request with authentication (similar to private endpoints) to allow you to access more data.

POST https://api.earnbit.com/api/v1/public/markets

Headers

Name

Type

Description

X-TXC-APIKEY*

STRING

Public API key

X-TXC-PAYLOAD*

STRING

Сonverted Base64 string containing body JSON

X-TXC-SIGNATURE*

STRING

Encrypted HmacSHA512 string containing body JSON with a API secret key

Request Body

Name

Type

Description

Example

request*

STRING

A request path without the domain name

/api/v1/public/markets

nonce*

NUMERIC

A 13-character number that must always be greater than the nonce of the previous completed request (we suggest generating a nonce as the UNIX timestamp in milliseconds)

1704070810000

CURL Example

curl --location --request POST 'https://api.earnbit.com/api/v1/public/markets' \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: 0000000000XXXXXXXXXXXXXXXXX' \
--header 'X-TXC-PAYLOAD: 0000000000XXXXXXXXXXXXXXXXX' \
--header 'X-TXC-SIGNATURE: 0000000000XXXXXXXXXXXXXXXXX' \
--data-raw '{"request":"/api/v1/public/markets","nonce":1704070810000}'

Response example:

{
    "code": 200,
    "success": true,
    "message": "",
    "result": [
        {
            "name": "SUSHI_BTC",
            "moneyPrec": 8,
            "stock": "SUSHI",
            "money": "BTC",
            "stockPrec": 8,
            "feePrec": 8,
            "minAmount": "0.001"
        },
        ...
    ]
}

Response example:

{
    "code": 400,
    "success": false,
    "message": "authentication failure",
    "result": []
}

This error occurs in the following cases:

The request was signed incorrectly.
Some of the provided parameters are incorrect.
Provided nonce is incorrect or less than on previous completed request
The base URL or path is incorrect.
The API keys are not activated.

Response example:

{    
    "timestamp": 1727100900,
    "status": 404,
    "error": "Not Found",
    "message": "",
    "path": "/api/v1/public/public/test"
}

This error occurs in the following cases:

The request was made with undefined data and the service cannot find the data for response.

PreviousPublic endpoints | HTTP NextPairs Stats

Last updated 6 months ago