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

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

{
    "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., ETHSpecify 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"
}

PreviousAPI Keys NextGet Transactions

Last updated 8 months ago