send [{"address":amount},{"data":"hex"},...] ( options )
EXPERIMENTAL warning: this call may be changed in future releases.
Send a transaction.
Arguments:
1. outputs (json array, required) A JSON array with outputs (key-value pairs), where none of the keys are duplicated.
That is, each address can only appear once and there can only be one 'data' object.
For convenience, a dictionary, which holds the key-value pairs directly, is also accepted.
[
{ (json object)
"address": amount, (numeric or string, required) A key-value pair. The key (string) is the bitcoin address, the value (float or string) is the amount in XEC
},
{ (json object)
"data": "hex", (string, required) A key-value pair. The key must be "data", the value is hex-encoded data
},
...
]
2. options (json object, optional) Options object that can be used to pass named arguments, listed below.
Named Arguments:
add_inputs (boolean, optional, default=false) If inputs are specified, automatically include more if they are not enough.
include_unsafe (boolean, optional, default=false) Include inputs that are not safe to spend (unconfirmed transactions from outside keys).
Warning: the resulting transaction may become invalid if one of the unsafe inputs disappears.
If that happens, you will need to fund the transaction with different inputs and republish it.
add_to_wallet (boolean, optional, default=true) When false, returns a serialized transaction which will not be added to the wallet or broadcast
change_address (string, optional, default=pool address) The bitcoin address to receive the change
change_position (numeric, optional, default=random) The index of the change output
fee_rate (numeric or string, optional, default=not set: makes wallet determine the fee) Set a specific fee rate in XEC/kB
include_watching (boolean, optional, default=true for watch-only wallets, otherwise false) Also select inputs which are watch only.
Only solvable inputs can be used. Watch-only destinations are solvable if the public key and/or output script was imported,
e.g. with 'importpubkey' or 'importmulti' with the 'pubkeys' or 'desc' field.
inputs (json array, optional, default=[]) Specify inputs instead of adding them automatically. A JSON array of JSON objects
[
"txid", (string, required) The transaction id
vout, (numeric, required) The output number
sequence, (numeric, required) The sequence number
...
]
locktime (numeric, optional, default=0) Raw locktime. Non-0 value also locktime-activates inputs
lock_unspents (boolean, optional, default=false) Lock selected unspent outputs
psbt (boolean, optional, default=automatic) Always return a PSBT, implies add_to_wallet=false.
subtract_fee_from_outputs (json array, optional, default=[]) Outputs to subtract the fee from, specified as integer indices.
The fee will be equally deducted from the amount of each specified output.
Those recipients will receive less bitcoins than you enter in their corresponding amount field.
If no outputs are specified here, the sender pays the fee.
[
vout_index, (numeric) The zero-based output index, before a change output is added.
...
]
Result:
{ (json object)
"complete" : true|false, (boolean) If the transaction has a complete set of signatures
"txid" : "hex", (string) The transaction id for the send. Only 1 transaction is created regardless of the number of addresses.
"hex" : "hex", (string) If add_to_wallet is false, the hex-encoded raw transaction with signature(s)
"psbt" : "str" (string) If more signatures are needed, or if add_to_wallet is false, the base64-encoded (partially) signed transaction
}
Examples:
Send with a fee rate of 10 XEC/kB
> bitcoin-cli send '{""qrmzys48glkpevp2l4t24jtcltc9hyzx9cep2qffm4"": 100000}' '{"fee_rate": 10}'
Create a transaction with a specific input, and return result without adding to wallet or broadcasting to the network
> bitcoin-cli send '{""qrmzys48glkpevp2l4t24jtcltc9hyzx9cep2qffm4"": 100000}' '{"add_to_wallet": false, "inputs": [{"txid":"a08e6907dbbd3d809776dbfc5d82e371b764ed838b5655e72f463568df1aadf0", "vout":1}]}'