# Get Transactions

## Query Transactions

<mark style="color:blue;">`GET`</mark> `https://api.aquanow.io/accounts/v2/transaction`

To view example requests for this endpoint, visit Aquanow's [Postman](https://developer.aquanow.io/#42cc9a93-3f51-4a98-8d19-be08227cd98f) documentation.<br>

**Possible query parameter combinations:** \
These are the only combinations that are currently supported. `limit` can be added to any of the combinations below. \
\
\- `txId`\
\
\- `txHash`

-`accountId` +`tag`\
\
-`accountId` + `address` + (`startTime` + `endTime`) optional

-`accountId` +`startTime` + `endTime`

-`accountId` +`transactionType`\
\
If the combination of the query parameters does not match one of the above, a 200 response will be returned with an empty data array.&#x20;

#### Query Parameters

| Name            | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| limit           | Number | <p>e.g.,<code>2</code></p><p>Limit the number of listed transactions. Must not be greater than 1000. </p>                                                                                                                                                                                                                                                                                                                            |
| transactionType | String | <p>e.g., <code>Withdraw</code><br>Filter by a supported transaction type.</p><p>One of <code>Conversion, Credit, Debit, Deposit, Internal\_Credit, Internal\_Debit, Withdraw</code></p>                                                                                                                                                                                                                                              |
| startTime       | Number | <p>e.g., <code>1569533825636</code></p><p>UTC timestamp in milliseconds. Specify the start time of transactions. If this is specified, <code>endTime</code> needs to be specified as well. </p>                                                                                                                                                                                                                                      |
| endTime         | Number | <p>e.g., <code>1572976325459</code></p><p>UTC timestamp in milliseconds. Specify the end time of transactions. </p><p>If this is specified, <code>startTime</code> needs to be specified as well. </p>                                                                                                                                                                                                                               |
| txId            | String | <p>e.g., <code>04cbakkdb3-795f-41fb-a70e-5df278cc4386</code></p><p>Specify the <code>txId</code> if you wish to get a single transaction by its ID. Not to be confused with <code>txHash</code>.</p>                                                                                                                                                                                                                                 |
| txHash          | String | <p>e.g.,<code>70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629</code></p><p>Specify the <code>txHash</code> (transactions hash) to get the corresponding transactions.</p><p></p><p><mark style="color:orange;">NOTE:</mark> This will only grab a transaction hash if it is a <code>txHash</code> associated with one of your transactions. It does <strong>NOT</strong> grab blockchain transaction hash data.</p> |
| address         | String | <p>e.g., <code>0x25F437f5fb89743D8bEccce3d348e898944DA832</code></p><p>Specify the associated address to get the corresponding transactions. You can optionally add <code>startTime</code> and <code>endTime</code> as well.</p>                                                                                                                                                                                                     |
| tag             | String | <p>e.g., <code>client</code></p><p>Specify the tag to get the corresponding transactions.</p>                                                                                                                                                                                                                                                                                                                                        |

#### Headers

| Name                                          | Type   | Description                                                                                                                                                        |
| --------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| x-api-key<mark style="color:red;">\*</mark>   | String | <p><code>{{x-api-key}}</code></p><p>API Auth Key</p>                                                                                                               |
| x-signature<mark style="color:red;">\*</mark> | String | <p><code>32c92460f65cbb78d0eaf9a4361fb6b0a2bb8bb4c40f531e9974a0afc12d9a328b5ff621a544d242ee9ba1dfa799c85a</code></p><p>Signature created using your API secret</p> |
| x-nonce<mark style="color:red;">\*</mark>     | String | <p><code>1657731573930</code></p><p>Timestamp in millisecond</p>                                                                                                   |

{% tabs %}
{% tab title="200: OK Get transactions" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "quantity": 299.99999,
      "networkType": "eth",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "bankInfo": {},
      "originUser": "helloWorld",
      "txId": "d1b41951-adc8-4ef4-9038-ac67ab70a05b",
      "symbol": "USDT",
      "txHash": "0xa8e1df18e8790b62f60ddc45b738b4116e8f298f0q",
      "createdAt": 1738096477410,
      "address": "0xD0795f990d484a461757f41723Q77",
      "transactionType": "WITHDRAW",
      "updatedAt": 1738096477410,
      "grossQuantity": 300,
      "username": "helloWorld",
      "tag": "my tag",
      "itemDateTime": 1738096477408,
      "adminApproval": "PROCESSING"
    },
    {
      "quantity": 10,
      "networkType": "eth",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "bankInfo": {},
      "txId": "f4fe4074-f2ca-47b7-b480-809656d3ad82",
      "symbol": "USDT",
      "createdAt": 1733961689977,
      "address": "0xD0795f990da265484a461757f40723B77",
      "transactionType": "WITHDRAW",
      "updatedAt": 1733961689977,
      "grossQuantity": 10.00001,
      "username": "helloWorld",
      "itemDateTime": 1733961689976,
      "adminApproval": "PROCESSING"
    },
    {
      "quantity": 1.099995,
      "networkType": "btc",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "bankInfo": {},
      "originUser": "helloWorld",
      "txId": "704bfc2b-f420-44q2-97cd-c71337712f39",
      "symbol": "BTC",
      "createdAt": 1733960913880,
      "address": "mwQB2Cd5GJsi1dQvppJ91YJZkPZ",
      "transactionType": "WITHDRAW",
      "updatedAt": 1733960913880,
      "grossQuantity": 1.1,
      "username": "helloWorld",
      "itemDateTime": 1733960913879,
      "adminApproval": "PROCESSING"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by time range" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "quantity": 10,
      "sourceAddress": "61157ee7-eabb-4d3d-a490-82f80c385bac",
      "networkType": false,
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "bankInfo": {},
      "originUser": "helloWorld",
      "txId": "61057ee7-ea1b-4d3d-a490-82f80c385bac",
      "symbol": "RENDER",
      "txHash": "61057ee7-e111-4d3d-a490-82f80c385bac",
      "createdAt": 1737586672032,
      "address": "7EcDhSYGxXyscszYEp35KHN8vsvAuLKTzXwCFLtV",
      "transactionType": "WITHDRAW",
      "dateSigned": 1737586735897,
      "updatedAt": 1737586735897,
      "grossQuantity": 10,
      "username": "helloWorld",
      "itemDateTime": 1737586672032,
      "adminApproval": "DONE"
    },
    {
      "quantity": 100000,
      "sourceAddress": "s",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "txId": "2d607da3-22a3-4bd4-948b-570e9e079c34",
      "symbol": "BTC",
      "createdAt": 1737586636052,
      "txTime": 1737586627700,
      "address": "0xD079590da265f5a6A74484a46sd57f41723B77",
      "transactionType": "DEPOSIT",
      "dateSigned": 1737586635852,
      "updatedAt": 1737586636052,
      "username": "helloWorld",
      "itemDateTime": 1737586627700,
      "adminApproval": "DONE"
    },
    {
      "quantity": 0.2,
      "sourceAddress": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
      "networkType": "sol",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "bankInfo": {},
      "originUser": "helloWorld",
      "txId": "a1c9f90f-2547-40ab-ba35-1127516f2472",
      "symbol": "USDT",
      "txHash": "a1c9f90f-2547-40ab-ba35-1127516f2472",
      "createdAt": 1737510029825,
      "address": "0xD079590da265f5a6A74484a46sd57f41723B77",
      "transactionType": "WITHDRAW",
      "dateSigned": 1737510073027,
      "updatedAt": 1737510073027,
      "grossQuantity": 0.2,
      "username": "helloWorld",
      "itemDateTime": 1737510029825,
      "adminApproval": "DONE"
    },
    {
      "quantity": 100,
      "sourceAddress": "s",
      "isAutopilotAddress": false,
      "accountId": "CA1264810R",
      "txId": "0b640077-0d85-4303-a494-2701110d7c79",
      "symbol": "ETH",
      "createdAt": 1737509704446,
      "txTime": 1737509456500,
      "address": "0xD07959asda265f5a6A74484a46s57f41723B77",
      "transactionType": "DEPOSIT",
      "dateSigned": 1737509704197,
      "updatedAt": 1737509704446,
      "username": "helloWorld",
      "itemDateTime": 1737509456500,
      "adminApproval": "DONE"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by transactionType and limit" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "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"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by txId" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "data": {
    "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"
  }
}
```

{% endtab %}

{% tab title="200: OK Get transactions by txHash" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "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"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by txId and time range" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "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"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by address" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "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"
    }
  ]
}
```

{% endtab %}

{% tab title="200: OK Get transactions by tag" %}
Returns an array of [TransactionV2Object](/aquanow/legacy/data-objects-and-statuses/transaction-objects.md#transactionv2object).

```json
{
  "pagination": {
    "startsAfter": "",
    "limit": 1000
  },
  "data": [
    {
      "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"
    }
  ]
}
```

{% endtab %}

{% tab title="400: Bad Request Get transactions if the params are invalid" %}
If `startTime` is passed in without an `endTime`:

```json
{
    "errors": [
        {
            "id": "46372ae1-39c9-47bf-88b1-we24n461876",
            "message": "must have required property 'endTime'"
        }
    ]
}
```

If the params are invalid:&#x20;

```json
{
    "errors": [
        {
            "id": "76372ae1-39c9-47bf-88b1-7418e560c948",
            "message": "Limit exceeds the maximum of 1000"
        }
    ]
}
```

If additional properties that are not defined above are passed in:

```json
{
    "errors": [
        {
            "id": "76369gt3-39c9-47bf-88b1-sh653-8hg5f62147",
            "message": "must NOT have additional properties"
        }
    ]
}
```

{% endtab %}

{% tab title="401: Unauthorized Get transactions if api-key is invalid" %}

```json
{
  "errors": [
    {
      "id": "76372ae1-39c9-47bf-88b1-7418e560c948",
      "message": "Unauthorized"
    }
  ]
}
```

{% endtab %}

{% tab title="500: Internal Server Error Get transactions returns a generic server error" %}

```json
{
  "errors": [
    {
      "id": "76372ae1-39c9-47bf-88b1-7418e560c948",
      "message": "There was a problem with grabbing data, please contact support"
    }
  ]
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aquanow.io/aquanow/legacy/api-endpoints-or-v2.0/transaction-api/get-transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.