Transaction API
Contains all endpoints regarding transactions. This includes different transaction types like withdrawals.
Fetch transactions
GET https://api.aquanow.io/accounts/v1/transaction
Fetches the transactions given by the query parameters associated to the authorized user.
To view example requests for this endpoint, visit Aquanow's Postman documentation.
Possible query parameter combinations:
These are the only combinations that are currently supported. limit can be added to any of the combinations below.
- txId
-tag
- txHash
-address + (startTime + endTime) optional
-startTime + endTime
-transactionType
If the combination of the query parameters does not match one of the above, a generic 500 response will be returned.
Query Parameters
limit
Number
e.g.,2
Limit the number of listed transactions. Must not be greater than 1000.
transactionType
String
e.g., Withdraw
Filter by a supported transaction type.
One of Conversion, Credit, Debit, Deposit, Internal_Credit, Internal_Debit, Withdraw
startTime
Number
e.g., 1569533825636
UTC timestamp in milliseconds. Specify the start time of transactions. If this is specified, endTime needs to be specified as well.
endTime
Number
e.g., 1572976325459
UTC timestamp in milliseconds. Specify the end time of transactions.
If this is specified, startTime needs to be specified as well.
txId
String
e.g., 04cbakkdb3-795f-41fb-a70e-5df278cc4386
Specify the txId if you wish to get a single transaction by its ID. Not to be confused with txHash.
txHash
String
e.g.,70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629
Specify the txHash (transactions hash) to get the corresponding transactions.
NOTE: This will only grab a transaction hash if it is a txHash associated with one of your transactions. It does NOT grab blockchain transaction hash data.
address
String
e.g., 0x25F437f5fb89743D8bEccce3d348e898944DA832
Specify the associated address to get the corresponding transactions. You can optionally add startTime and endTime as well.
tag
String
e.g., client
Specify the tag to get the corresponding transactions.
Headers
x-api-key*
String
{{x-api-key}}
API Auth Key
x-signature*
String
32c92460f65cbb78d0eaf9a4361fb6b0a2bb8bb4c40f531e9974a0afc12d9a328b5ff621a544d242ee9ba1dfa799c85a
Signature created using your API secret
x-nonce*
String
1657731573930
Timestamp in millisecond
Returns an array of TransactionObject.
[
{
"quantity": 0.005,
"symbol": "BTC",
"txHash": "3e9839efd0e8b92631648f06c2c32e724b87af194ca05f5a0bbeccc6cbbad98b",
"updatedAt": 1569964868510,
"createdAt": 1569964868510,
"username": "helloWorld",
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"itemDateTime": 1569964868509,
"transactionType": "WITHDRAW",
"adminApproval": "DONE"
},
{
"quantity": 0.004,
"symbol": "BTC",
"txHash": "a302e62611fc2f3b6736e63eb9f034f45819abe750719693d033209841552b5a",
"updatedAt": 1569975516918,
"createdAt": 1569975516918,
"username": "helloWorld",
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"itemDateTime": 1569975516917,
"transactionType": "WITHDRAW",
"adminApproval": "DONE"
}
]Returns an array of TransactionObject.
[
{
"quantity": 0.01,
"isAutopilotAddress": false,
"symbol": "BTC",
"orderId": "N/A",
"txHash": "asdf",
"txTime": 1569533338550,
"createdAt": 1569533339142,
"address": "asdfgg",
"fiatReceived": "N/A ",
"transactionType": "DEPOSIT",
"dateSigned": 1569533338550,
"updatedAt": 1569533339142,
"username": "helloWorld",
"itemDateTime": 1569533335000,
"adminApproval": "DONE"
},
{
"quantity": 1,
"isAutopilotAddress": false,
"symbol": "ETH",
"orderId": "N/A",
"txHash": "asdddddfff",
"txTime": 1569533360187,
"createdAt": 1569533359148,
"address": "N/A",
"fiatReceived": "N/A ",
"transactionType": "DEPOSIT",
"dateSigned": 1569533360187,
"updatedAt": 1569533359148,
"username": "helloWorld",
"itemDateTime": 1569533355000,
"adminApproval": "DONE"
},
{
"quantity": 1,
"currencyTag": "asdf",
"isAutopilotAddress": false,
"symbol": "LTC",
"orderId": "N/A",
"txHash": "asdf",
"txTime": 1569533383967,
"createdAt": 1569533382954,
"address": "N/A",
"fiatReceived": "N/A ",
"transactionType": "DEPOSIT",
"dateSigned": 1569533383967,
"updatedAt": 1569533382954,
"username": "helloWorld",
"itemDateTime": 1569533380000,
"adminApproval": "DONE"
},
{
"quantity": 10,
"isAutopilotAddress": false,
"symbol": "USD",
"orderId": "N/A",
"txHash": "sgfsdgf",
"txTime": 1569533598552,
"createdAt": 1569533599222,
"address": "N/A",
"fiatReceived": "N/A ",
"transactionType": "DEPOSIT",
"dateSigned": 1569533598563,
"updatedAt": 1569533599222,
"username": "helloWorld",
"itemDateTime": 1569533586000,
"adminApproval": "DONE"
},
{
"quantity": 10,
"isAutopilotAddress": false,
"symbol": "CAD",
"orderId": "N/A",
"txHash": "dsgedrfg",
"txTime": 1569533662396,
"createdAt": 1569533663059,
"address": "N/A",
"fiatReceived": "N/A ",
"transactionType": "WITHDRAW",
"dateSigned": 1569533662396,
"updatedAt": 1569533663059,
"username": "helloWorld",
"itemDateTime": 1569533652000,
"adminApproval": "DONE"
},
{
"quantity": 0.01,
"symbol": "BTC",
"txHash": "0b5944c49dcb6feee4b7fefecb7ebd01e4d3ba7de0d527e96baf126072229310",
"updatedAt": 1569533803546,
"createdAt": 1569533803546,
"username": "helloWorld",
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"itemDateTime": 1569533803546,
"transactionType": "WITHDRAW",
"adminApproval": "DONE",
},
{
"quantity": 0.01,
"symbol": "BTC",
"txHash": "bfdf10c9a7acb10a5d92216470bca9044bbd32bdf442bb89b3bd8f97dcf9c348",
"updatedAt": 1569533816965,
"createdAt": 1569533816965,
"username": "helloWorld",
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"itemDateTime": 1569533816965,
"transactionType": "WITHDRAW",
"adminApproval": "DONE"
},
{
"quantity": 0.01,
"isAutopilotAddress": false,
"symbol": "LTC",
"createdAt": 1569533825636,
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"transactionType": "WITHDRAW",
"isCompleted": false,
"dateSigned": 1569545162132,
"updatedAt": 1569545162132,
"networkFee": 0,
"username": "helloWorld",
"itemDateTime": 1569533825636,
"adminApproval": "DONE"
},
{
"quantity": 1e-9,
"isAutopilotAddress": false,
"symbol": "BTC",
"createdAt": 1572976325459,
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"transactionType": "WITHDRAW",
"retroActive": true,
"freeOrNot": true,
"updatedAt": 1572976325459,
"networkFee": 0,
"username": "helloWorld",
"itemDateTime": 1572976325459,
"adminApproval": "PROCESSING"
}
]Returns an array of TransactionObject.
[
{
"quantity": 1e-9,
"isAutopilotAddress": false,
"symbol": "BTC",
"createdAt": 1572976325459,
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"transactionType": "WITHDRAW",
"updatedAt": 1572976325459,
"username": "helloWorld",
"itemDateTime": 1572976325459,
"adminApproval": "PROCESSING"
},
{
"quantity": 0.01,
"isAutopilotAddress": false,
"symbol": "LTC",
"createdAt": 1569533825636,
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"transactionType": "WITHDRAW",
"dateSigned": 1569545162132,
"updatedAt": 1569545162132,
"username": "helloWorld",
"itemDateTime": 1569533825636,
"adminApproval": "DONE"
},
{
"quantity": 0.01,
"symbol": "BTC",
"txHash": "bfdf10c9a7acb10a5d92216470bca9044bbd32bdf442bb89b3bd8f97dcf9c348",
"updatedAt": 1569533816965,
"createdAt": 1569533816965,
"username": "helloWorld",
"address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
"itemDateTime": 1569533816965,
"transactionType": "WITHDRAW",
"adminApproval": "DONE",
}
Returns an array of TransactionObject.
{
"quantity": 0.17558213,
"strategy": "SOR",
"isAutopilotAddress": true,
"txId": "04cbadb3-795f-41fb-a70e-5df278cc4386",
"symbol": "BTC",
"orderId": "f1e98c7c-c9cd-44ab-b665-52726aaa6a64",
"txHash": "70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629",
"txTime": 1591841077000,
"createdAt": 1592327455594,
"fiat": "USD",
"address": "2NDUK4P74P185KM4YrHCtKjebvsSVtgaHQA",
"fiatReceived": 1666.63575,
"transactionType": "DEPOSIT",
"dateSigned": 1592327424982,
"tradeSide": "sell",
"updatedAt": 1592327455594,
"username": "helloWorld",
"tag": "superman",
"itemDateTime": 1592327424982,
"adminApproval": "DONE"
Returns an array of TransactionObject.
[
{
"quantity": 0.17558213,
"strategy": "SOR",
"isAutopilotAddress": true,
"txId": "04cbadb3-795f-41fb-a70e-5df278cc4386",
"txHash": "70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629",
"symbol": "BTC",
"orderId": "f1e98c7c-c9cd-44ab-b665-52726aaa6a64",
"txTime": 1591841077000,
"createdAt": 1592327455594,
"fiat": "USD",
"address": "2NDUK4P74P185KM4YrHCtKjebvsSVtgaHQA",
"fiatReceived": 1666.63575,
"transactionType": "DEPOSIT",
"dateSigned": 1592327424982,
"tradeSide": "sell",
"updatedAt": 1592327455594,
"username": "helloWorld",
"tag": "superman",
"itemDateTime": 1592327424982,
"adminApproval": "DONE"
}
]Returns an array of TransactionObject.
[
{
"quantity": 0.1,
"isAutopilotAddress": false,
"txId": "d322d0ea-e3f2-4bdc-99a4-9c98d00cf46e",
"symbol": "ETH",
"txHash": "0x5b8a1667242877b9e8707377eda81a2acdfad33f17ee272b9a5dd2ec6c702887",
"createdAt": 1608609671489,
"txTime": 1608609668871,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"transactionType": "DEPOSIT",
"dateSigned": 1608609671322,
"updatedAt": 1608609671489,
"username": "helloWorld",
"itemDateTime": 1608609668871,
"adminApproval": "DONE"
},
{
"quantity": 0.1,
"isAutopilotAddress": true,
"txId": "a7896c0e-786b-4206-9e18-4c730406deff",
"orderId": "33c67a61-dc97-4c16-8d02-dae4f5d7ebc1",
"symbol": "ETH",
"txHash": "0x10755237859b0098b8fb133c69ec2e752f5599911b4f2abd9caabce71177ff01",
"createdAt": 1607672964551,
"txTime": 1607672926506,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"fiatReceived": 43.06512,
"transactionType": "DEPOSIT",
"dateSigned": 1607672930238,
"updatedAt": 1607672964551,
"username": "helloWorld",
"itemDateTime": 1607672926506,
"adminApproval": "DONE"
}
]Returns an array of TransactionObject.
[
{
"quantity": 0.01,
"isAutopilotAddress": false,
"txId": "28b673ef-4e5c-43e3-b9a8-310d35b92c6a",
"symbol": "ETH",
"txHash": "0x4d2dbf6e4f3d28d464d7fec542a81ca1af2ce289a1e38fd8b7f30ef6d164ec65",
"createdAt": 1609812611159,
"txTime": 1609812029169,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"transactionType": "DEPOSIT",
"dateSigned": 1609812610971,
"updatedAt": 1609812611159,
"username": "helloWorld",
"itemDateTime": 1609812029169,
"adminApproval": "DONE"
},
{
"quantity": 0.1,
"isAutopilotAddress": false,
"txId": "d322d0ea-e3f2-4bdc-99a4-9c98d00cf46e",
"symbol": "ETH",
"txHash": "0x5b8a1667242877b9e8707377eda81a2acdfad33f17ee272b9a5dd2ec6c702887",
"createdAt": 1608609671489,
"txTime": 1608609668871,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"transactionType": "DEPOSIT",
"dateSigned": 1608609671322,
"updatedAt": 1608609671489,
"username": "helloWorld",
"itemDateTime": 1608609668871,
"adminApproval": "DONE"
},
{
"quantity": 0.1,
"isAutopilotAddress": true,
"txId": "a7896c0e-786b-4206-9e18-4c730406deff",
"orderId": "33c67a61-dc97-4c16-8d02-dae4f5d7ebc1",
"symbol": "ETH",
"txHash": "0x10755237859b0098b8fb133c69ec2e752f5599911b4f2abd9caabce71177ff01",
"createdAt": 1607672964551,
"txTime": 1607672926506,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"fiatReceived": 43.06512,
"transactionType": "DEPOSIT",
"dateSigned": 1607672930238,
"updatedAt": 1607672964551,
"username": "helloWorld",
"itemDateTime": 1607672926506,
"adminApproval": "DONE"
},
{
"quantity": 0.05,
"isAutopilotAddress": true,
"txId": "b0f44606-3f7f-4cc4-91f1-2eb7894a5eab",
"orderId": "a9a9e1b8-81a6-420f-bea3-40e2367178d3",
"symbol": "ETH",
"txHash": "0x6484e70fb9b2a5e9f460654716f0a221314393877f0b56d34065a4bab07ac21b",
"createdAt": 1607671064116,
"txTime": 1607671005021,
"address": "0x25F437f5fb89743D8bEccce3d348e898944DA832",
"fiatReceived": 21.53256,
"transactionType": "DEPOSIT",
"dateSigned": 1607671029689,
"updatedAt": 1607671064116,
"username": "helloWorld",
"itemDateTime": 1607671005021,
"adminApproval": "DONE"
}
]Returns an array of TransactionObject.
[
{
"quantity": 200,
"isAutopilotAddress": false,
"txId": "7016b12c-1779-4655-b781-c07af98def22",
"symbol": "EUR",
"createdAt": 1596492108673,
"txTime": 2020,
"address": "NDgyNjg",
"transactionType": "DEPOSIT",
"dateSigned": 1596492108515,
"updatedAt": 1596492108673,
"username": "helloWorld",
"tag": "iban",
"itemDateTime": 1596492108515,
"adminApproval": "DONE"
},
{
"quantity": 69,
"isAutopilotAddress": false,
"txId": "a4493cc7-c78d-4fa1-a485-3615cedae600",
"symbol": "USD",
"createdAt": 1594681087399,
"txTime": 2020,
"address": "NDgyNzA",
"transactionType": "DEPOSIT",
"dateSigned": 1594681087259,
"updatedAt": 1594681087399,
"username": "helloWorld",
"tag": "iban",
"itemDateTime": 1594681087259,
"adminApproval": "DONE"
},
{
"quantity": 100,
"isAutopilotAddress": false,
"txId": "b0779dfe-9390-4830-a76c-60df74eb61df",
"symbol": "EUR",
"createdAt": 1596492108717,
"txTime": 2020,
"address": "NDgyNjg",
"transactionType": "DEPOSIT",
"dateSigned": 1596492108577,
"updatedAt": 1596492108717,
"username": "helloWorld",
"tag": "iban",
"itemDateTime": 1596492108577,
"adminApproval": "DONE"
},
{
"quantity": 500000,
"isAutopilotAddress": false,
"txId": "fa6b06e2-2a48-4304-b4be-2c6d3f0ffcac",
"symbol": "EUR",
"createdAt": 1596060108559,
"txTime": 2020,
"address": "NDgyNjg",
"transactionType": "DEPOSIT",
"dateSigned": 1596060108405,
"updatedAt": 1596060108559,
"username": "helloWorld",
"tag": "iban",
"itemDateTime": 1596060108405,
"adminApproval": "DONE"
}
]If startTime is passed in without an endTime:
{
"message": "must have required property 'endTime'"
}If the params are invalid:
{
"message": "Limit exceeds the maximum of 1000"
}If additional properties that are not defined above are passed in:
{
"message": "must NOT have additional properties"
}{
"message": "There was a problem with grabbing data, please contact support"
}Request a crypto withdrawal
POST https://api.aquanow.io/accounts/v1/transaction
To view example requests for this endpoint, visit Aquanow's Postman documentation.
Headers
x-api-key*
String
{{x-api-key}}
API Auth Key
x-signature*
String
49c6260c194f4d7ed5cb917dc70b9821673246b2abc1cf28f05df6a75fd24181e00f8e57b321d15ae45db58b3bffe27a
Signature created using your API secret
x-nonce*
Number
1618307861949
Timestamp in millisecond
Content-Type*
String
application/json
Request Body
symbol*
String
e.g., BTC
All uppercase letters, the crypto currency you are withdrawing.
address*
String
Destination address you are withdrawing to.
quantity*
Number
Quantity you wish to withdraw.
NOTE: You must have sufficient funds to be able to withdraw.
transactionType*
String
e.g., WITHDRAW
Type of transaction.
NOTE: Currently, we only support WITHDRAW requests
currencyTag
String
Additional address property (Tag/Memo) that allows identifying the transfer beneficiary or destination for a transaction.
tag
String
Additional reference id that you can send with a withdrawal request.
networkType
String
e.g., ETH
Specify a networkType for symbols that support multiple networks.
One of ETH, TRON,XLM, FTM, MATIC
NOTE: Only applicable to USDT, USDC, MATIC, and FTM coins.
message
String
Additional field to add any messages/notes.
status
String
e.g., DONE
Denotes the status of the withdrawal. Can be one of DONE or PROCESSING
txHash
String
e.g.,70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629
Specify the txHash (transactions hash) for transactions that are DONE
NOTE: This does not create a new transaction on the blockchain.
Returns a TransactionObject.
{
"itemDateTime": 1667206700438,
"adminApproval": "PROCESSING",
"networkType": "xrp",
"address": "1EasiKeuuxEyjGwZfWF3Xh1muNjGpjDmeA",
"networkFeeAqua": 0,
"quantity": 0.005,
"bankInfo": {},
"txId": "8c7e0127-e5b2-48c8-9fac-5ad8c3eca69d",
"symbol": "BTC",
"username": "helloWorld",
"transactionType": "WITHDRAW",
"createdAt": 1667206700438,
"updatedAt": 1667206700438
}Returns a TransactionObject.
{
"retroActive": true,
"networkType": "xrp",
"address": "rNXQc5mT7b336bFTkenFTPiF5TYuyrJ3ZH",
"quantity": 100,
"bankInfo": {},
"txId": "cca72591-db39-4f06-b483-364b73eac43c",
"symbol": "XRP",
"tag": "some-id-1-reference",
"username": "helloWorld",
"goToAdmin": true
}Returns a TransactionObject.
{
"itemDateTime": 1667204771386,
"networkType": "xrp",
"address": "rNXQc5mT7b336bFTkenFTPiF5TYuyrJ3ZH",
"quantity": 100,
"bankInfo": {},
"currencyTag": "2307171792",
"txId": "730b96c4-729e-460f-93e6-96af0a045ab7",
"symbol": "XRP",
"username": "helloWorld",
"freeOrNot": true,
"transactionType": "WITHDRAW",
"isAutopilotAddress": false,
"adminApproval": "PROCESSING",
"createdAt": 1667204771386,
"updatedAt": 1667204771386
}{
"message": "Please provide an address"
}{
"message": "Insufficient Funds"
}{
"message": "Provided network type does not exist"
}Last updated