> 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-stats.md). # Pairs Stats ### Details `GET` `https://api.earnbit.com/api/v1/public/tickers`
CURL Example ```javascript curl -X GET "https://api.earnbit.com/api/v1/public/tickers" -H "accept: application/json" ```
{% tabs %} {% tab title="200: OK Successful" %} **Response parameters:** | Name | Type | Description | | ------ | :-----: | :--------------------------------------------: | | name | STRING | Pair name | | bid | NUMERIC | Highest bid | | ask | NUMERIC | Lowest ask | | open | NUMERIC | Open price for the last 24 hours | | high | NUMERIC | Highest price for the last 24 hours | | low | NUMERIC | Lowest price for the last 24 hours | | last | NUMERIC | Last deal price | | vol | NUMERIC | Volume in stock currency | | deal | NUMERIC | Volume in money currency | | change | NUMERIC | Change in percent between open and last prices | **Response example:** ```javascript { "code": 200, "success": true, "message": "", "result": { "ETH_USDT": { "at": 1660809000, "ticker": { "name": "ETH_USDT", "bid": "11064.19562386", "ask": "11075.01503353", "open": "11283.75679587", "high": "11672.94242464", "low": "10907.76734965", "last": "11062.46620831", "vol": "4826.8414807", "deal": "54127712.90288253218", "change": "-1" } }, ... } } ``` {% 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/tickers-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/tickers` #### 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/tickers
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/tickers' \ --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/tickers","nonce":1704070810000}' ```
{% tabs %} {% tab title="200: OK Successful" %} **Response example:** ```javascript { "code": 200, "success": true, "message": "", "result": { "PEPE_USDT": { "at": 1727780839, "ticker": { "name": "PEPE_USDT", "bid": "0.00001245", "ask": "0.00001257", "open": "0.00001257", "high": "0.00001257", "low": "0.00001257", "last": "0.00001257", "vol": "200000", "deal": "2.514", "change": "0" } }, } } ``` {% 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": 1727100901, "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 %}