Skip to main content

Get transactions

POST getTransactions

To identify transaction, use getTransactions with the ID from the createTransaction/createFixTransaction response.

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

HTTP request

https://api.changelly.com/v2/#getTransactions

Request

Header parameters
NameTypeRequiredDescription
X-Api-KeystringtrueYour API key (SHA256 from Public Key)
X-Api-SignaturestringtrueThe query's serialized body signed by your private key according to the RSA-SHA256 method.

Body parameters

NameTypeRequiredDescription
jsonrpcstringtrueJSON-RPC version.
idstringtrueClient's custom ID.
methodstringtrueAPI method name.
paramsobjecttrueRequest parameters.

params object:

NameTypeRequiredDescription
idstring or array of stringsfalseTransaction ID. The maximum array length is 10.
statusstring or array of stringsfalseTransaction status.
currencystring or array of stringsfalsePayin currency ticker (in lowercase). The maximum array length is 10.
addressstring or array of stringsfalsePayin address. The maximum array length is 10.
payoutAddressstring or array of stringsfalsePayout address. The maximum array length is 10.
extraIdstringfalseAdditional ID for address for currencies that use additional ID for transaction processing.
sinceintegerfalseUnix 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.
limitintegerfalseNumber of records to retrieve. The maximum limit is 100. By default, 10.
offsetintegerfalseRecords cursor.
subaccountIdstringfalsesubaccountId from createSubaccount. Use it to filter transactions by user.

Response

Sample response

Example 1
application/json
{
"jsonrpc": "2.0",
"id": "test",
"result": [
{
"id": "uzul********97b",
"createdAt": 1664897070000000,
"type": "fixed",
"moneyReceived": 1664897109000000,
"moneySent": 1664897441000000,
"rate": "14.41196637",
"payinConfirmations": "1",
"status": "finished",
"currencyFrom": "btc",
"currencyTo": "eth",
"payinAddress": "3Fi6v6s**************bLNkQPD",
"payinExtraId": null,
"payinExtraIdName": null,
"payinHash": "669d7d63*****************68e401c4c542",
"payoutHashLink": "https://etherscan.io/tx/0x66f72ac0dd*********************387c20a21",
"refundHashLink": null,
"amountExpectedFrom": "0.00422367",
"payoutAddress": "0x5Fb48bc0******************feE3Cf2a",
"payoutExtraId": null,
"payoutExtraIdName": null,
"payoutHash": "0x66f72ac0d***************************56387c20a21",
"refundHash": null,
"refundAddress": "bc1qxm9w***********************cz7atv5",
"refundExtraId": null,
"amountFrom": "0.00422367",
"amountTo": "0.06087139",
"amountExpectedTo": "0.06087139",
"networkFee": "0.00233395",
"changellyFee": "0.4",
"apiExtraFee": "2.00",
"totalFee": "0.00233395",
"canPush": false,
"canRefund": false
},
{
"id": "ccud********os91",
"createdAt": 1664888443000000,
"type": "fixed",
"moneyReceived": 1664888456000000,
"moneySent": 1664889182000000,
"rate": "11.09727112",
"payinConfirmations": "2",
"status": "finished",
"currencyFrom": "xrp",
"currencyTo": "gala",
"payinAddress": "rUjd8QPJ**************vQC6dwe",
"payinExtraId": "93******79",
"payinExtraIdName": "Destination Tag",
"payinHash": "A67B08EE0C4***********************A7FDF7365333C",
"payoutHashLink": "https://etherscan.io/tx/0x5be5c44f11****************2befeb103e64a",
"refundHashLink": null,
"amountExpectedFrom": "10000",
"payoutAddress": "0x95c63a1******************3bd775d90",
"payoutExtraId": null,
"payoutExtraIdName": null,
"payoutHash": "0x5be5c44f1197d********************2befeb103e64a",
"refundHash": null,
"refundAddress": "rDaS8t8m***********JZxo9JKr",
"refundExtraId": null,
"amountFrom": "10000",
"amountTo": "110972.71124334",
"amountExpectedTo": "110972.71124334",
"networkFee": "105",
"changellyFee": "0.5",
"apiExtraFee": "2.00",
"totalFee": "105",
"canPush": false,
"canRefund": false
}
]
}
Example 2
application/json
{
"jsonrpc": "2.0",
"id": "test",
"result": [
{
"id": "ldis********dnys",
"createdAt": 1617187096000000,
"type": "float",
"moneyReceived": 0,
"moneySent": 0,
"rate": "0.00021545",
"payinConfirmations": "0",
"status": "waiting",
"currencyFrom": "xlm",
"currencyTo": "eth",
"payinAddress": "GDX6FFZUVSYTOV****************HUXXPXYOUIOY6CDQXG4NP6OEQ7",
"payinExtraId": "9783********7653",
"payinExtraIdName": "Memo.ID",
"payinHash": null,
"payoutHashLink": null,
"refundHashLink": null,
"amountExpectedFrom": "500",
"payoutAddress": "0xCde3463364****************73d7f91136Ac34",
"payoutExtraId": null,
"payoutExtraIdName": null,
"payoutHash": null,
"refundHash": null,
"amountFrom": "",
"amountTo": "0",
"amountExpectedTo": "0.10746",
"networkFee": "0",
"apiExtraFee": "0.00",
"totalFee": null,
"canPush": false,
"canRefund": false
}
]
}