> For the complete documentation index, see [llms.txt](https://earnbit.gitbook.io/earnbit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://earnbit.gitbook.io/earnbit/developers/exchange-api-documentation/public-endpoints-or-http/pairs-list.md). # Pairs List ### Details `GET` `https://api.earnbit.com/api/v1/public/markets`
CURL Example ```javascript curl -X GET "https://api.earnbit.com/api/v1/public/markets" -H "accept: application/json" ```
{% tabs %} {% tab title="200: OK Successful" %} **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:** ```javascript { "code": 200, "success": true, "message": "", "result": [ { "name": "SSV_USDT", "moneyPrec": 8, "stock": "SSV", "money": "USDT", "stockPrec": 8, "feePrec": 8, "minAmount": "0.001" }, ... ] } ``` {% endtab %} {% tab title="400: Bad Request " %} **Response example:** ```javascript 400 Bad Request

400 Bad Request

nginx
``` **This error occurs in the following cases:** * Invalid URL * Request contains invalid headers {% endtab %} {% tab title="404: Not Found " %} **Response example:** ```javascript { "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 {% endtab %} {% endtabs %} ### With Authentication This public endpoint can also be used as a `POST` request with [authentication](/earnbit/developers/exchange-api-documentation/private-endpoints-or-http/authentication-and-api-keys.md) (similar to [private endpoints](/earnbit/developers/exchange-api-documentation/private-endpoints-or-http.md)) 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](/earnbit/developers/exchange-api-documentation/private-endpoints-or-http/authentication-and-api-keys.md) | | 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
NameTypeDescriptionExample
request*STRINGA request path without the domain name/api/v1/public/markets
nonce*NUMERICA 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 ```javascript 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}' ```
{% tabs %} {% tab title="200: OK Successful" %} **Response example:** ```javascript { "code": 200, "success": true, "message": "", "result": [ { "name": "SUSHI_BTC", "moneyPrec": 8, "stock": "SUSHI", "money": "BTC", "stockPrec": 8, "feePrec": 8, "minAmount": "0.001" }, ... ] } ``` {% endtab %} {% tab title="400: Authentication Failure " %} **Response example:** ```javascript { "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](/earnbit/developers/exchange-api-documentation/private-endpoints-or-http/authentication-and-api-keys.md) is incorrect or less than on previous completed request * The base URL or path is incorrect. * The API keys are not [activated](/earnbit/developers/exchange-api-documentation/private-endpoints-or-http/authentication-and-api-keys.md). {% endtab %} {% tab title="404: Not Found " %} **Response example:** ```javascript { "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. {% endtab %} {% endtabs %}