Market History Data

That method returns the history of trading on a specific pair.

Details

GET https://api.pointpay.io/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)

limit

NUMERIC

How many trades to display (default = 50, min = 1, max = 1000)

CURL Example

curl -X GET "https://api.pointpay.io/api/v1/public/history/result?market=BTC_USDT&since=0&limit=5" -H "accept: application/json"

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:

[
    {
        "tid": 1255714991,
        "date": 1660805464,
        "price": "23384.04568438",
        "type": "sell",
        "amount": "0.26",
        "total": "6079.85187794"
    },
            ...
]

Response example 1:

<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:

One or more query parameters are invalid
The request contains invalid headers

Response example 2:

{
    "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:

{
    "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.

Response example:

{
    "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

With Authentication

POST https://api.pointpay.io/api/v1/public/history/result

Headers

Name

Type

Description

X-TXC-APIKEY*

STRING

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)

limit

NUMERIC

How many trades to display (default = 50, min = 1, max = 1000)

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

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":"PXP_USDT","since":0,"limit":10,"request":"/api/v1/public/history/result","nonce":1704070810000}'

Response example:

[
    {
        "tid": 1029021270,
        "date": 1727776395,
        "price": "3.2",
        "type": "buy",
        "amount": "18",
        "total": "57.6"
    },
    ...
}

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.
The base URL or path is incorrect.

Response example:

{    
    "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.

PreviousMarket History NextProducts

Last updated 7 months ago

[ { "tid": 1255714991, "date": 1660805464, "price": "23384.04568438", "type": "sell", "amount": "0.26", "total": "6079.85187794" }, ... ]

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":"PXP_USDT","since":0,"limit":10,"request":"/api/v1/public/history/result","nonce":1704070810000}'