# Transaction

## Send Transaction

<mark style="color:green;">`POST`</mark> `https://api.walletcloud.app/wallet/:walletId/send`

This endpoint allows you to send transactions to the blockchain. To begin sending transactions out of your wallet, your wallet has to have a wallet balance that is at least the minimum balance of the wallet. For ETH and all the supported tokens in the Ethereum ecosystem, the minimum wallet balance is **0.005ETH**. Any request to send a transaction when the wallet balance is less than the minimum will be rejected.&#x20;

#### Path Parameters

| Name                                       | Type   | Description                                |
| ------------------------------------------ | ------ | ------------------------------------------ |
| walletId<mark style="color:red;">\*</mark> | string | ID of the wallet to send transaction from. |

#### Headers

| Name                                        | Type   | Description                                       |
| ------------------------------------------- | ------ | ------------------------------------------------- |
| x-api-key<mark style="color:red;">\*</mark> | string | Api key of the wallet to send a transaction from. |

#### Request Body

| Name                                        | Type   | Description                                                                                                  |
| ------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------ |
| amount<mark style="color:red;">\*</mark>    | number | Amount of cypto to send.                                                                                     |
| recipient<mark style="color:red;">\*</mark> | string | <p>Destination address.<br><strong>Example</strong>: <em>0x9086b928658D473380E5c6f80FC5419e8fd98e60</em></p> |
| coin<mark style="color:red;">\*</mark>      | string | Token or cypto symbol to be sent. Example: eth, usdt , usdc, btc, etc.                                       |

{% tabs %}
{% tab title="200 Transaction sent successfully." %}

```javascript
{
    "status": true,
    "message": "Transaction sent successfully!",
    "data": {
        "transactionId": "3eb7ab75-70d9-4c1a-9908-3a10dc260efe",
        "amount": 0.0005,
        "hash": "0xf84f79fa083b54a16db5d06f0929fb0f1a20d4d1e01284a8299970645edf50c2",
        "sender": "0xc7a02a762Ab0175c80249b5d4f703Bb01A9f053B",
        "receiver": "0x9086b928658D473380E5c6f80FC5419e8fd98e60",
        "currency": "eth",
        "walletId": "14b7efd3-fae6-4cef-ae21-589d9d19d784",
        "blockchain": "Ethereum",
        "network": "testnet",
        "blockNumber": 0,
        "confirmations": 0,
        "status": "SENT",
        "type": "OUTGOING",
        "createdAt": 1623686600533,
        "updatedAt": 1623686600533
    }
}
```

{% endtab %}

{% tab title="400 Transaction could not be sent." %}

```javascript
{
    "status": false,
    "message": "Transaction could not be sent.",
    "data": "Recipient address is invalid."
}
```

{% endtab %}
{% endtabs %}

## Get Transaction

<mark style="color:blue;">`GET`</mark> `https://api.walletcloud.app/wallet/:walletId/transaction/:transactionId`

Get a wallet transaction.

#### Path Parameters

| Name                                            | Type   | Description                                      |
| ----------------------------------------------- | ------ | ------------------------------------------------ |
| walletId<mark style="color:red;">\*</mark>      | string | ID of the wallet to retrieve a transaction from. |
| transactionId<mark style="color:red;">\*</mark> | string | Transaction ID of the transaction.               |

#### Headers

| Name                                        | Type   | Description                                      |
| ------------------------------------------- | ------ | ------------------------------------------------ |
| x-api-key<mark style="color:red;">\*</mark> | string | Api key of the wallet from the wallet dashboard. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "status": true,
    "message": "Transaction successfully retrieved!",
    "data": {
        "amount": 0.0005,
        "receiver": "0x9086b928658D473380E5c6f80FC5419e8fd98e60",
        "currency": "eth",
        "status": "SENT",
        "date": "Monday, June 14, 2021 6:09 PM",
        "walletId": "14b7efd3-fae6-4cef-ae21-589d9d19d784",
        "transactionId": "3d4d511d-e25f-4ffb-9dfe-b3d688a8ed98",
        "network": "testnet",
        "sender": "0xc7a02a762Ab0175c80249b5d4f703Bb01A9f053B",
        "hash": "0xd78353e8ca2885e0f156cff6929b86f7aceef08cc09ea184d5bfd8b5939c7f69",
        "blockchain": "Ethereum",
        "type": "OUTGOING"
    }
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{
    "status": false,
    "message": "Transaction could not be retrieved",
    "data": {}
}
```

{% endtab %}
{% endtabs %}

## List Transactions

<mark style="color:blue;">`GET`</mark> `https://api.walletcloud.app/wallet/:walletId/transactions`

Retrieve all transactions from a wallet.&#x20;

#### Path Parameters

| Name                                       | Type   | Description                                 |
| ------------------------------------------ | ------ | ------------------------------------------- |
| walletId<mark style="color:red;">\*</mark> | string | ID of wallet to retrieve transactions from. |

#### Query Parameters

| Name        | Type    | Description                                                                                                                                                                                      |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| nextItemKey | string  | The start key of the next batch of transactions to fetch.                                                                                                                                        |
| limit       | integer | <p>Maximum number of results to return per request. If the result set is truncated, use <code>nextItemKey</code> to get the next batch.<br><br><strong>Default</strong>: <strong>25</strong></p> |

#### Headers

| Name                                        | Type   | Description                                          |
| ------------------------------------------- | ------ | ---------------------------------------------------- |
| x-api-key<mark style="color:red;">\*</mark> | string | Api key of the wallet to retrieve transactions from. |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "status": true,
    "message": "Transactions successfully retrieved!",
    "data": {
        "transactions": [
            {
                "amount": 0.0015,
                "receiver": "0x9086b928658D473380E5c6f80FC5419e8fd98e60",
                "currency": "eth",
                "status": "SENT",
                "date": "Monday, June 14, 2021 1:32 AM",
                "walletId": "14b7efd3-fae6-4cef-ae21-589d9d19d784",
                "transactionId": "8f887520-8683-4a89-91e2-92f385021a13",
                "network": "testnet",
                "sender": "0xc7a02a762Ab0175c80249b5d4f703Bb01A9f053B",
                "hash": "0xc990eca6faf2210f511039178e69724d2d4161f7c689aaf1ce6583edc6118e98",
                "blockchain": "Ethereum",
                "type": "OUTGOING"
            },
            {
                "amount": 0.0005,
                "receiver": "0x9086b928658D473380E5c6f80FC5419e8fd98e60",
                "currency": "eth",
                "status": "SENT",
                "date": "Monday, June 14, 2021 8:30 PM",
                "walletId": "14b7efd3-fae6-4cef-ae21-589d9d19d784",
                "transactionId": "466f241b-a2f3-454f-9318-b4a475a67fa4",
                "network": "testnet",
                "sender": "0xc7a02a762Ab0175c80249b5d4f703Bb01A9f053B",
                "hash": "0xe2be4b07692c5a3acdfd6f0bbe7b727392de8fce5c3b7a0af958bddc7a4d7109",
                "blockchain": "Ethereum",
                "type": "OUTGOING"
            }
        ],
        "nextItemKey": "eyJ3YWxsZXRJZCI6IjE0YjdlZmQzLWZhZTYtNGNlZi1hZTIxLTU4OWQ5ZDE5ZDc4NCIsInRyYW5zYWN0aW9uSWQiOiI0NjZmMjQxYi1hMmYzLTQ1NGYtOTMxOC1iNGE0NzVhNjdmYTQiLCJzdGF0dXMiOiJTRU5UIn0="
    }
}
```

{% 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://walletcloud.gitbook.io/walletcloud-api/api-1/transaction.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.