# Transaction API

## Fetch transactions

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

Fetches the transactions given by the query parameters associated to the authorized user.&#x20;

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`

-`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.&#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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

```json
[
  {
    "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"
  }
]
```

{% endtab %}

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

```json
[
    {
        "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"
    }
]
```

{% endtab %}

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

```json
[
    {
        "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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

```json
{
  "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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

```json
[
  {
    "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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

```json
[
  {
    "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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

```json
[
  {
    "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 [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

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

<pre><code><strong>{
</strong>    "message": "must have required property 'endTime'"
}
</code></pre>

If the params are invalid:&#x20;

```
{
    "message": "Limit exceeds the maximum of 1000"
}
```

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

```json
{
    "message": "must NOT have additional properties"
}
```

{% endtab %}

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

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

{% endtab %}

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

```
{
    "message": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}

## Request a crypto withdrawal

<mark style="color:green;">`POST`</mark> `https://api.aquanow.io/accounts/v1/transaction`

To view example requests for this endpoint, visit Aquanow's [Postman](https://developer.aquanow.io/#4462eccb-a588-4590-a6c5-7dac5816356f) documentation.

#### 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>49c6260c194f4d7ed5cb917dc70b9821673246b2abc1cf28f05df6a75fd24181e00f8e57b321d15ae45db58b3bffe27a</code></p><p>Signature created using your API secret</p> |
| x-nonce<mark style="color:red;">\*</mark>      | Number | <p><code>1618307861949</code></p><p>Timestamp in millisecond</p>                                                                                                   |
| Content-Type<mark style="color:red;">\*</mark> | String | `application/json`                                                                                                                                                 |

#### Request Body

| Name                                              | Type   | Description                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| symbol<mark style="color:red;">\*</mark>          | String | <p>e.g., <code>BTC</code></p><p>All uppercase letters, the crypto currency you are withdrawing.</p>                                                                                                                                                                                                                                           |
| address<mark style="color:red;">\*</mark>         | String | Destination address you are withdrawing to.                                                                                                                                                                                                                                                                                                   |
| quantity<mark style="color:red;">\*</mark>        | Number | <p>Quantity you wish to withdraw. </p><p></p><p><mark style="color:orange;">NOTE:</mark> You must have sufficient funds to be able to withdraw.</p>                                                                                                                                                                                           |
| transactionType<mark style="color:red;">\*</mark> | String | <p>e.g., <code>WITHDRAW</code></p><p>Type of transaction.</p><p></p><p><mark style="color:orange;">NOTE:</mark> Currently, we only support <code>WITHDRAW</code> requests</p>                                                                                                                                                                 |
| 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 | <p>e.g., <code>ETH</code> <br>Specify a <code>networkType</code> for symbols that support multiple networks.</p><p>One of <code>ETH</code>, <code>TRON</code>,<code>XLM</code>, <code>FTM</code>, <code>MATIC</code></p><p><mark style="color:orange;">NOTE:</mark> Only applicable to <strong>USDT, USDC, MATIC, and FTM</strong> coins.</p> |
| message                                           | String | Additional field to add any messages/notes.                                                                                                                                                                                                                                                                                                   |
| status                                            | String | <p>e.g., <code>DONE</code><br>Denotes the status of the withdrawal. Can be one of <code>DONE</code> or <code>PROCESSING</code></p>                                                                                                                                                                                                            |
| txHash                                            | String | <p>e.g.,<code>70a867671a6e01e91f5888d800d3978e2ec9aec6770740572a0a485b7d4b6629</code></p><p>Specify the <code>txHash</code> (transactions hash) for transactions that are <code>DONE</code></p><p></p><p><mark style="color:orange;">NOTE:</mark> This does not create a new transaction on the blockchain.</p>                               |

{% tabs %}
{% tab title="200: OK Create transaction" %}
Returns a [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

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

{% endtab %}

{% tab title="200: OK Create transaction with tag" %}
Returns a [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

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

{% endtab %}

{% tab title="200: OK Create transaction with currencyTag" %}
Returns a [TransactionObject](https://docs.aquanow.io/aquanow/legacy/data-objects-and-statuses/transaction-objects#transactionobject).

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

{% endtab %}

{% tab title="400: Bad Request Missing address" %}

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

{% endtab %}

{% tab title="400: Bad Request Insufficient funds" %}

```json
{
    "message": "Insufficient Funds"
}
```

{% endtab %}

{% tab title="400: Bad Request Invalid networkType" %}

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

{% endtab %}
{% endtabs %}