> 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/market-history-data.md).
# Market History Data
### Details
`GET` `https://api.earnbit.com/api/v1/public/history/result`
#### Query Parameters
| Name | Type | Description | |
| ---------------------------------------- | ------- | --------------------------------------------------------------- | --------- |
| market\* | STRING | Any public pair | BTC\_USDT |
| since\* | NUMERIC | How mane last trades to skip (default = 0) | 0 |
| limit | NUMERIC | How many trades to display (default = 50, min = 1, max = 1000) | 5 |
CURL Example
```javascript
curl -X GET "https://api.earnbit.com/api/v1/public/history/result?market=BTC_USDT&since=0&limit=5" -H "accept: application/json"
```
{% tabs %}
{% tab title="200: OK Successful" %}
**Response parameters:**
| Name | Type | Description |
| :----: | :-----: | ---------------------------------------- |
| tid | NUMERIC | Trade ID |
| date | NUMERIC | Trade time (TimeStamp format) |
| price | STRING | Trade price |
| type | STRING | Trade type (buy / sell) |
| amount | STRING | Trade amount (in 1st ticker of the pair) |
| total | STRING | Trade amount (in 2nd ticker of the pair) |
**Response example:**
```javascript
[
{
"tid": 1255714991,
"date": 1660805464,
"price": "23384.04568438",
"type": "sell",
"amount": "0.26",
"total": "6079.85187794"
},
...
]
```
{% endtab %}
{% tab title="400: Bad Request " %}
**Response example 1:**
```javascript
400 Bad Request
400 Bad Request
nginx
```
**This error occurs in the following cases:**
* One or more query parameters are invalid
* The request contains invalid headers
**Response example 2:**
```javascript
{
"code": 400,
"success": false,
"message": "invalid input",
"result": []
}
```
**This error occurs in the following cases:**
* The query parameter `market` was not provided in the request.
* One or more query parameters in the request contain invalid values.
**Response example 3:**
```javascript
{
"code": 400,
"success": false,
"message": {
"since": [
"The since field is required."
]
},
"result": []
}
```
**This error occurs in the following cases:**
* The query parameter `since` was not provided in the request.
* The query parameter `since` was provided incorrectly.
{% endtab %}
{% tab title="404: Not Found " %}
**Response example:**
```javascript
{
"timestamp": 1660766043722,
"status": 404,
"error": "Not Found",
"message": "",
"path": "/api/v1/public/history/result-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/history/result`
#### 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
| Name | Type | Description | |
| ----------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
| market\* | STRING | Any public pair | BTC\_USDT |
| since\* | NUMERIC | How mane last trades to skip (default = 0) | 0 |
| limit | NUMERIC | How many trades to display (default = 50, min = 1, max = 1000) | 10 |
| request\* | STRING | A request path without the domain name | /api/v1/public/history/result |
| 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
```javascript
curl --location --request POST 'https://api.pointpay.io/api/v1/public/history/result' \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: 0000000000XXXXXXXXXXXXXXXXX' \
--header 'X-TXC-PAYLOAD: 0000000000XXXXXXXXXXXXXXXXX' \
--header 'X-TXC-SIGNATURE: 0000000000XXXXXXXXXXXXXXXXX' \
--data-raw '{"market":"BTC_USDT","since":0,"limit":10,"request":"/api/v1/public/history/result","nonce":1704070810000}'
```
{% tabs %}
{% tab title="200: OK Successful" %}
**Response example:**
```javascript
[
{
"tid": 1029021270,
"date": 1727776395,
"price": "3.2",
"type": "buy",
"amount": "18",
"total": "57.6"
},
...
}
```
{% 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": 1727100905,
"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 %}