Get Transactions

Queries the transactions given by the query parameters associated to the authorized user.

Query Transactions

GET https://api.aquanow.io/accounts/v1/transaction

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.01,
      "sourceAddress": "bc1qxk904wl2urmfpapnf875wy5f3ns682xtxg6vqq",
      "networkType": "btc",
      "isAutopilotAddress": false,
      "accountId": "CA1000051R",
      "bankInfo": {},
      "originUser": "helloWorldUser",
      "txId": "185fb322-ee9a-49dc-8a22-fc9c7357e426",
      "symbol": "BTC",
      "txHash": "60d68a8f2edd770f913c41cce4bb44c73feb31fc69c6833105a6001dddab4410",
      "createdAt": 1712611540332,
      "address": "bc1q8k5508tfz299v7ywxj8j4g4p9hkn6n06xndv0d",
      "transactionType": "WITHDRAW",
      "dateSigned": 1712613947184,
      "updatedAt": 1712613967137,
      "networkFee": 2.1e-7,
      "username": "helloWorld",
      "itemDateTime": 1712611540325,
      "adminApproval": "DONE"
  },
  {
      "quantity": 0.9,
      "sourceAddress": "0x2E4b48f88Fb1a0A79B6173C53dAd5678dC894B59",
      "networkType": "eth",
      "isAutopilotAddress": false,
      "accountId": "CA1000049R",
      "bankInfo": {},
      "originUser": "helloWorldUser",
      "txId": "316eb842-2686-49ea-9835-572797ac472b",
      "symbol": "ETH",
      "txHash": "0x133bf0a2c26126b87493101443cccee0ceab7e5d34a853d75888a95708816ad4",
      "createdAt": 1710968046176,
      "address": "0xEE506212EE33ac1ac66D56e9Ea5D5866e8C7168e",
      "transactionType": "WITHDRAW",
      "dateSigned": 1712614282865,
      "updatedAt": 1712614287013,
      "networkFee": 0.09,
      "username": "helloWorld",
      "itemDateTime": 1710968046174,
      "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 with grossQuantity

Returns an array of TransactionObject.

[
  {
    "quantity": 0.045,
    "grossQuantity": 0.05,
    "networkFee": "0.005"
    "symbol": "BTC",
    "txHash": "3e9839efd0e8b92631648f06c2c32e724b87af194ca05f5a0bbeccc6cbbad98b",
    "updatedAt": 1569964868510,
    "createdAt": 1569964868510,
    "username": "helloWorld",
    "address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
    "itemDateTime": 1569964868509,
    "transactionType": "WITHDRAW",
    "adminApproval": "DONE"
  },
  {
    "quantity": 0.95,
    "grossQuantity": 1,
    "networkFee": "0.05"
    "symbol": "BTC",
    "txHash": "a302e62611fc2f3b6736e63eb9f034f45819abe750719693d033209841552b5a",
    "updatedAt": 1569975516918,
    "createdAt": 1569975516918,
    "username": "helloWorld",
    "address": "CD7iJgfC1BF1a26LuTxAuQ35E5TSPsTsDr",
    "itemDateTime": 1569975516917,
    "transactionType": "WITHDRAW",
    "adminApproval": "DONE"
  }
]

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

401: Unauthorized Get transactions if api-key is invalid

{
    "message": "Unauthorized"
}

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

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