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

Name	Type	Description
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

Name	Type	Description
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

200: OK Get transactions

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"
  }
]

200: OK Get transactions by time range

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"
    }
]

200: OK Get transactions by transactionType and limit

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",
    }

200: OK Get transactions by txId

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"

200: OK Get transactions by txHash

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"
  }
]

200: OK Get transactions by txId and time range

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"
  }
]

200: OK Get transactions by address

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"
  }
]

200: OK Get transactions by tag

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"
  }
]

400: Bad Request Get transactions if the params are invalid

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

500: Internal Server Error Get transactions returns a generic server error

{
    "message": "There was a problem with grabbing data, please contact support"
}

401: Unauthorized Get transactions if api-key is invalid

{
    "message": "Unauthorized"
}

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

Name	Type	Description
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

Name	Type	Description
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.
accountId	String	e.g., CA1000012R Specify the accountId of the sub-account.
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.

200: OK Create transaction

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
}

400: Bad Request Missing address

{
    "message": "Please provide an address"
}

400: Bad Request Insufficient funds

{
    "message": "Insufficient Funds"
}

200: OK Create transaction with tag

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
}

200: OK Create transaction with currencyTag

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
}

400: Bad Request Invalid networkType

{
    "message": "Provided network type does not exist"
}