Documentation exported from Bitcoin Core 0.17.99

sendmany (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

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

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

Arguments

1. "dummy"

string

required

Must be set to “” for backwards compatibility.

2. "amounts"

string

required

A json object with addresses and amounts

    {
      "address":amount

numeric or string

The bitcoin address is the key, the numeric amount (can be string) in BTC is the value

      ,...
    }
3. minconf

numeric

optional

default=1

Only use the balance confirmed at least this many times.

4. "comment"

string

optional

A comment

5. subtractfeefrom

array

optional

A json array with addresses. The fee will be equally deducted from the amount of each selected address. Those recipients will receive less bitcoins 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

      ,...
    ]
6. replaceable

boolean

optional

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

7. conf_target

numeric

optional

Confirmation target (in blocks)

8. "estimate_mode"

string

optional

default=UNSET

The fee estimate mode, must be one of:

  • “UNSET”
  • “ECONOMICAL”
  • “CONSERVATIVE”

Result

"txid"

string

The transaction id for the send. Only 1 transaction is created regardless of the number of addresses.

Examples

Send two amounts to two different addresses

bitcoin-cli sendmany "" "{\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\":0.01,\"1353tsE8YMTA4EuV7dgUXGjNFf9KpVvKHz\":0.02}"

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

bitcoin-cli sendmany "" "{\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\":0.01,\"1353tsE8YMTA4EuV7dgUXGjNFf9KpVvKHz\":0.02}" 6 "testing"

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

bitcoin-cli sendmany "" "{\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\":0.01,\"1353tsE8YMTA4EuV7dgUXGjNFf9KpVvKHz\":0.02}" 1 "" "[\"1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX\",\"1353tsE8YMTA4EuV7dgUXGjNFf9KpVvKHz\"]"

As a json rpc call

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