Skip to main content

sendmany

sendmany "" {"address":amount} ( minconf "comment" ["address",...] replaceable conf_target "estimate_mode" fee_rate verbose )

Send multiple times. Amounts are double-precision floating point numbers.

Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Argument #1 - dummy​

Type: string, required

Must be set to "" for backwards compatibility.

Argument #2 - amounts​

Type: json object, required

The addresses and amounts

{
  "address": amount,    (numeric or string, required) The bitgesell address is the key, the numeric amount (can be string) in BGL is the value
}

Argument #3 - minconf​

Type: numeric, optional

Ignored dummy value

Argument #4 - comment​

Type: string, optional

A comment

Argument #5 - subtractfeefrom​

Type: json array, optional

The addresses.

The fee will be equally deducted from the amount of each selected address. Those recipients will receive less bitgesells than you enter in their corresponding amount field. If no addresses are specified here, the sender pays the fee.

[
"address", (string) Subtract fee from this address
...
]

Argument #6 - replaceable​

Type: boolean, optional, default=wallet default

Allow this transaction to be replaced by a transaction with higher fees via BIP 125

Argument #7 - conf_target​

Type: numeric, optional, default=wallet -txconfirmtarget

Confirmation target in blocks

Argument #8 - estimate_mode​

Type: string, optional, default=unset

The fee estimate mode, must be one of (case insensitive):

"unset" "economical" "conservative"

Argument #9 - fee_rate​

Type: numeric or string, optional, default=not set, fall back to wallet fee estimation

Specify a fee rate in sat/vB.

Result (if verbose is not set or set to false)​

NameTypeDescription
hexstringThe transaction id for the send. Only 1 transaction is created regardless of

Result (if verbose is set to true)​

{ (json object)
"txid" : "hex", (string) The transaction id for the send. Only 1 transaction is created regardless of
the number of addresses.
"fee reason" : "str" (string) The transaction fee reason.
}

Example usage (with RPC call)​

Send two amounts to two different addresses::

 BGL-cli sendmany "" "{"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl":0.01,"bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3":0.02}"

Send two amounts to two different addresses setting the confirmation and comment::

BGL-cli sendmany "" "{\"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl\":0.01,\"bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3\":0.02}" 6 "testing"

Send two amounts to two different addresses, subtract fee from amount::

BGL-cli sendmany "" "{\"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl\":0.01,\"bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3\":0.02}" 1 "" "[\"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl\",\"bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3\"]"

As a JSON-RPC call:

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "sendmany", "params": ["", {"bc1q09vm5lfy0j5reeulh4x5752q25uqqvz34hufdl":0.01,"bc1q02ad21edsxd23d32dfgqqsz4vv4nmtfzuklhy3":0.02}, 6, "testing"]}' -H 'content-type: text/plain;' http://127.0.0.1:8334/