My Trades Info

This method returns information about trades of a specific user's order.

Details

POST https://api.pointpay.io/api/v1/account/trades

Headers

Name	Type	Description
X-TXC-APIKEY*	STRING	Public API key
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	Example
orderId*	NUMERIC	Order ID	1041123323
offset	STRING	Amount of trades to skip (default = 0)	0
limit	STRING	Amount of trades to show (default = 50)	2
request*	STRING	A request path without the domain name	/api/v1/account/trades
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/account/trades' \
--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/account/trades","orderId":1041123323,"offset":0,"limit":2,"nonce":1704070810000}'

200: OK Successful

Response example:

Name	Type	Description
id	NUMERIC	Trade ID
time	NUMERIC	Trade time (TimeStamp format)
fee	STRING	Trade fee
price	STRING	Trade price
amount	STRING	Trade amount (in 1st ticker of pair)
dealOrderId	NUMERIC	Order ID
role	NUMERIC	Trade role (1 = taker, 2 = maker)
deal	STRING	Trade amount (in 2nd ticker of pair)

Response example:

{
    "code": 200,
    "success": true,
    "message": "",
    "result": {
        "offset": 0,
        "limit": 2,
        "records": [
            {
                "id": 227431,
                "time": 1727870021.583000,
                "fee": "0.00000699011525",
                "price": "61444.153801",
                "amount": "0.01644733",
                "dealOrderId": 1041116923,
                "role": 2,
                "deal": "1010.59227413580133"
            },
            {
                "id": 227429,
                "time": 1727870021.583000,
                "fee": "0.00000873935575",
                "price": "61436.092995",
                "amount": "0.02056319",
                "dealOrderId": 1041117044,
                "role": 2,
                "deal": "1263.32205311385405"
            }
        ]
    }
}

400: Bad Request

Response example 1:

{
    "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 is incorrect or less than on previous completed request

• The base URL or path is incorrect.

• The API keys are not activated.

Response example 2:

{
    "code": 400,
    "success": false,
    "message": "invalid input",
    "result": []
}

This error occurs in the following cases:

• One or more body params provided incorrectly

• Required body params are not provided

404: Not Found

Response example:

{    
    "timestamp": 1660811292806,
    "status": 404,
    "error": "Not Found",
    "message": "",
    "path": "/api/v1/order/test"
}

This error occurs in the following cases:

• The request was made with undefined data and the service cannot find the data for response.