sendmany

Back to wallet

Changed params/results since v30.2 Wallet

Summary

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

Description

Send multiple times. Amounts are double-precision floating point numbers. Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Change Buckets

  • Changed params/results since v30.2

Arguments

  • dummy (STR): Must be set to "" for backwards compatibility.
  • amounts (OBJ_USER_KEYS, required): The addresses and amounts
  • address (AMOUNT, required): The qbit address is the key, the numeric amount (can be string) in QBT is the value
  • minconf (NUM): Ignored dummy value
  • comment (STR): A comment
  • subtractfeefrom (ARR): The addresses. The fee will be equally deducted from the amount of each selected address. Those recipients will receive less QBT than you enter in their corresponding amount field. If no addresses are specified here, the sender pays the fee.
  • address (STR): Subtract fee from this address
  • replaceable (BOOL): Signal that this transaction can be replaced by a transaction (BIP 125)
  • conf_target (NUM): Confirmation target in blocks

  • estimate_mode (STR): The fee estimate mode, must be one of (case insensitive): unset, economical, conservative unset means no mode set (economical mode is used if the transaction is replaceable; otherwise, conservative mode is used). economical estimates use a shorter time horizon, making them more responsive to short-term drops in the prevailing fee market. This mode potentially returns a lower fee rate estimate. conservative estimates use a longer time horizon, making them less responsive to short-term drops in the prevailing fee market. This mode potentially returns a higher fee rate estimate.

  • fee_rate (AMOUNT): Specify a fee rate in sat/vB.

  • verbose (BOOL): If true, return extra information about the transaction.

Results

  • txid (STR_HEX): The transaction id for the send. Only 1 transaction is created regardless of the number of addresses.
  • value (OBJ): No description.
  • txid (STR_HEX): The transaction id for the send. Only 1 transaction is created regardless of the number of addresses.
  • fee_reason (STR): The transaction fee reason.
  • pqc_key_states (ARR, optional): PQC usage state for local wallet keys that participated in this response.
    • value (OBJ): No description.
    • pubkey (STR_HEX): The hex-encoded PQC public key.
    • pqc_signature_count (NUM): The number of signatures used by this PQC key.
    • pqc_signature_limit (NUM): The hard signature limit for this PQC key.
    • pqc_signatures_remaining (NUM): The remaining signature budget for this PQC key.
    • pqc_limit_state (STR): The PQC usage state. One of normal, warning, critical, or exhausted.
  • pqc_overall_limit_state (STR, optional): The maximum PQC usage severity across pqc_key_states.
  • pqc_signature_count (NUM, optional): The number of signatures used by the single local PQC key associated with this response.
  • pqc_signature_limit (NUM, optional): The hard signature limit for the single local PQC key associated with this response.
  • pqc_signatures_remaining (NUM, optional): The remaining signature budget for the single local PQC key associated with this response.
  • pqc_limit_state (STR, optional): The PQC usage state for the single local PQC key associated with this response.
  • warnings (ARR, optional): Human-readable warning lines emitted when PQC threshold transitions or reminder buckets fire.
    • warning (STR): No description.

Examples

Send two amounts to two different addresses:

qbit-cli sendmany "" "{\"qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw\":0.01,\"qb1zyqsjygeyy5nzw2pf9g4jctfw9ucrzv3nxs6nvdec8yark0pa8clsj9cmtx\":0.02}"

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

qbit-cli sendmany "" "{\"qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw\":0.01,\"qb1zyqsjygeyy5nzw2pf9g4jctfw9ucrzv3nxs6nvdec8yark0pa8clsj9cmtx\":0.02}" 6 "testing"

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

qbit-cli sendmany "" "{\"qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw\":0.01,\"qb1zyqsjygeyy5nzw2pf9g4jctfw9ucrzv3nxs6nvdec8yark0pa8clsj9cmtx\":0.02}" 1 "" "[\"qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw\",\"qb1zyqsjygeyy5nzw2pf9g4jctfw9ucrzv3nxs6nvdec8yark0pa8clsj9cmtx\"]"

As a JSON-RPC call

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "sendmany", "params": ["", {"qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw":0.01,"qb1zyqsjygeyy5nzw2pf9g4jctfw9ucrzv3nxs6nvdec8yark0pa8clsj9cmtx":0.02}, 6, "testing"]}' -H 'content-type: application/json' http://127.0.0.1:8352/