# Transfer

## Transfer

Send XHV to a number of recipients.

Alias: *None*.

### Inputs:

* `destinations` - array of destinations to receive XHV:
  * *amount* - unsigned int; Amount to send to each destination, in @atomic-units.
  * *address* - string; Destination public address.
* `account_index` - unsigned int; (Optional) Transfer from this account index. (Defaults to 0)
* `subaddr_indices` - array of unsigned int; (Optional) Transfer from this set of subaddresses. (Defaults to empty - all indices)
* `priority` - unsigned int; Set a priority for the transaction. Accepted Values are: 0-3 for: default, unimportant, normal, elevated, priority.
* `mixin` - unsigned int; Number of outputs from the blockchain to mix with (0 means no mixing).
* `ring_size` - unsigned int; Number of outputs to mix in the transaction (this output + N decoys from the blockchain).
* `unlock_time` - unsigned int; Number of blocks before the haven can be spent (0 to not add a lock).
* `get_tx_key` - boolean; (Optional) Return the transaction key after sending.
* `do_not_relay` - boolean; (Optional) If true, the newly created transaction will not be relayed to the haven network. (Defaults to false)
* `get_tx_hex` - boolean; Return the transaction as hex string after sending (Defaults to false)
* `get_tx_metadata` - boolean; Return the metadata needed to relay the transaction. (Defaults to false)

### Outputs:

* `amount` - Amount transferred for the transaction.
* `amount_usd` - Amount transferred for the transaction.
* `fee` - Integer value of the fee charged for the txn.
* `multisig_txset` - Set of multisig transactions in the process of being signed (empty for non-multisig).
* `tx_blob` - Raw transaction represented as hex string, if get\_tx\_hex is true.
* `tx_hash` - String for the publically searchable transaction hash.
* `tx_key` - String for the transaction key if get\_tx\_key is true, otherwise, blank string.
* `tx_metadata` - Set of transaction metadata needed to relay this transfer later, if get\_tx\_metadata is true.
* `unsigned_txset` - String. Set of unsigned tx for cold-signing purposes.

### Example

```
$ curl http://127.0.0.1:17751/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"transfer","params":{"destinations":[{"amount":100000000000,"address":"hvxy5mxT87WWDCfsAYYEtq9K8KNbPTRaEd2nKgLgPN3qP5PpH1AaJ6TaYYec9L2hKZGpuxQ4uZ4tkFFLxjaLHVAY7QZoBmW3g2"},{"amount":200000000000,"address":"hvxy5mxT87WWDCfsAYYEtq9K8KNbPTRaEd2nKgLgPN3qP5PpH1AaJ6TaYYec9L2hKZGpuxQ4uZ4tkFFLxjaLHVAY7QZoBmW3g2"}],"account_index":0,"subaddr_indices":[0],"priority":0,"ring_size":7,"get_tx_key": true}}' -H 'Content-Type: application/json'
{
  "id": "0",
  "jsonrpc": "2.0",
  "result": {
    "amount": 300000000000,
    "fee": 86897600000,
    "multisig_txset": "",
    "tx_blob": "",
    "tx_hash": "7663438de4f72b25a0e395b770ea9ecf7108cd2f0c4b75be0b14a103d3362be9",
    "tx_key": "25c9d8ec20045c80c93d665c9d3684aab7335f8b2cd02e1ba2638485afd1c70e236c4bdd7a2f1cb511dbf466f13421bdf8df988b7b969c448ca6239d7251490e4bf1bbf9f6ffacffdcdc93b9d1648ec499eada4d6b4e02ce92d4a1c0452e5d009fbbbf15b549df8856205a4c7bda6338d82c823f911acd00cb75850b198c5803",
    "tx_metadata": "",
    "unsigned_txset": ""
  }
```


---

# 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://wiki.havenprotocol.org/rpc/rpc-overview/rpc-transfer.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.