generatetoaddress

generating dangerous since 0.13.0

mines to a specified address and returns the block hashes.

↑ shares the docs page. Use Share this query below for a link with your current arg values.

Not executable from the web. Would harm the node, the network, or expose secrets. Documentation only, never executable from the web.

Call from your own code

Replace $BITCOIN_RPC_USER / $BITCOIN_RPC_PASSWORD with credentials from your bitcoind's bitcoin.conf, and replace localhost:8332 with your node's RPC address. You can't run this RPC against our node, but you can run it against your own bitcoind.

Help

generatetoaddress nblocks "address" ( maxtries )

Mine to a specified address and return the block hashes.

Arguments:
1. nblocks     (numeric, required) How many blocks are generated.
2. address     (string, required) The address to send the newly generated bitcoin to.
3. maxtries    (numeric, optional, default=1000000) How many iterations to try.

Result:
[           (json array) hashes of blocks generated
  "hex",    (string) blockhash
  ...
]

Examples:

Generate 11 blocks to myaddress
> bitcoin-cli generatetoaddress 11 "myaddress"
If you are using the Bitcoin Core wallet, you can get a new address to send the newly generated bitcoin to with:
> bitcoin-cli getnewaddress

← back to all RPCs