Get private transactions

To identify transaction, use getPrivateSendTransactions with the ID from the createPrivateSendTransaction response.

You can use getPrivateSendTransactions method with other filters to improve user experience.

HTTP request

post/v2/#getPrivateSendTransactions

Request

Header parameters

Requires authentication.

Body parameters

Requires JSON-RPC 2.0 protocol request body.

The params parameter schema:

Name	Type	Required	Description
id	string	false	Transaction ID.
status	string	false	Transaction status.
currency	string	false	Currency ticker (in lowercase).
payinAddress	string	false	Recipient address.
payoutAddress	string	false	Receiver address.
payoutExtraId	string	false	Additional ID for address for currencies that use additional ID for transaction processing.
since	integer	false	Unix timestamp in microseconds (16 digits). A filter that limits the results to records where the createdAt value is greater than or equal to the since value.
before	integer	false	Unix timestamp in microseconds (16 digits). A filter that limits the results to records where the createdAt value is less than the before value.
limit	integer	false	Number of records to retrieve. The maximum limit is 100. By default, 10.
offset	integer	false	Records cursor.

Sample request payload

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "getPrivateSendTransactions",
  "params": {
    "currency": "eth",
    "address": "<<payin address to search>>",
    "payoutAddress": "<<payout address to search>>"
  }
}

Sample cURL

curl --location --request POST 'https://api.changelly.com/v2' \
--header 'X-Api-Key: {{apiKey}}' \
--header 'X-Api-Signature: {{sign}}' \
--data-raw '{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "getPrivateSendTransactions",
  "params": {
    "currency": "eth",
    "address": "<<payin address to search>>",
    "payoutAddress": "<<payout address to search>>"
  }
}'

Response

Response parameters

Requires JSON-RPC 2.0 protocol response body.

The result parameter schema:

Name	Type	Description
id	string	Transaction ID. Could be used in getStatus method.
createdAt	integer	Time in timestamp format (microseconds) when the transaction was created.
payinConfirmations	string	Number of confirmations.
status	string	Transaction status. Will always be new when transaction is created.
currency	string	Payin currency ticker.
amount	string	The estimated payout amount before withholding the network fee.
payinAddress	string	Address for a user to send coins to.
payinExtraId	string	Additional ID for payinAddress in case it is required.
payoutHash	string	Hash of the payout transaction.
payoutAddress	string	Recipient address.
payoutExtraId	string	Additional ID for address for currencies that use additional ID for transaction processing.
serviceFee	string	Commission taken by Changelly from the amount sent to the user. Displayed in payout currency.
moneyReceived	integer	The time in timestamp format (microseconds) of receiving the funds by Changelly. moneyReceived equals 0 if Changelly hasn't received the funds yet.
moneySent	integer	The time in timestamp format (microseconds) of sending the funds to the user by Changelly. moneySent is not returned if Changelly hasn't sent the funds yet.

Sample response with 1 transaction

application/json

{
  "jsonrpc": "2.0",
  "id": "test",
  "result": [
    {
        'id': 'xj666xd0kyzm9ikz',
        'createdAt': 1657278685000000,
        'payinConfirmations': 1,
        'status': 'waiting',
        'currency': 'eth',
        'payinAddress': '0x0c7c*******************e318ea',
        'payinHash': 'asdf*******************sdf',
        'payoutAddress': '0x576e*******************1499a9',
        'payoutHash': '1234*******************1234',
        'amount': '0.2934325',
        'serviceFee': '0.00009'
    }
  ]
}

Error response

Error response parameters

Check the error response schema.

Error codes

Code	Message	Description
-32601	Method not found	The method you're calling doesn't exist.
-32603	Error: You reached requests limit {limit} rps	You have sent requests more than the RPS limit. The default RPS limit is 10.
-32603	Internal Error or Error	Most likely, the problem is on our side. Further investigation is required.

---