> 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/symbols.md). # Symbols ### Details `GET` `https://api.earnbit.com/api/v1/public/symbols`
CURL Example ```javascript curl -X GET "https://api.earnbit.com/api/v1/public/symbols" -H "accept: application/json" ```
{% tabs %} {% tab title="200: OK Successful" %} **Response parameters:** | Name | Type | Desciption | | :--: | :----: | ---------- | | pair | STRING | Pair name | **Response example:** ```javascript { "code": 200, "success": true, "message": "", "result": [ "SSV_USDT", // pair "EGLD_USDT", // pair "SKL_USDT", // pair "INJ_BTC", // pair ... ] } ``` {% 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/symbols-test" } ``` **This error occurs in the following cases:** * The requested URL was not found. Please check the endpoint and try again {% 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/symbols` #### 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/symbols
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/symbols' \ --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/symbols","nonce":1704070810000}' ```
{% tabs %} {% tab title="200: OK Successful" %} **Response example:** ```javascript { "code": 200, "success": true, "message": "", "result": [ "SUSHI_BTC", "WLD_USDT", "USDC_USDT", ... ] } ``` {% 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": 1727100907, "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 %}