getnewaddress

getnewaddress ( "label" "address_type" ) Returns a new Bitcoin address for receiving payments. If 'label' is specified, it is added to the address book so payments received with the address will be associated with 'label'. Note: Witness v2 (post-quantum ML-DSA) addresses are NOT supported by this RPC. Use 'generatemldsaaddress' for witness v2 addresses instead. Arguments: 1. label (string, optional, default="") The label name for the address to be linked to. It can also be set to the empty string "" to represent the default label. The label does not need to exist, it will be created if there is no label by the given name. 2. address_type (string, optional, default=set by -addresstype) The address type to use. Options are "legacy", "p2sh-segwit", "bech32", and "bech32m". Does NOT support "v2" or witness v2. Result: "str" (string) The new bitcoin address Examples: > bitcoin-cli getnewaddress > curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getnewaddress", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8332/

Signature

getnewaddress(label?: string, address_type?: string) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getnewaddress","params":["","set by -addresstype"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli getnewaddress

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getnewaddress", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getnewaddress",
        "params": ["", "set by -addresstype"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getnewaddress",
    params: ["","set by -addresstype"],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
label	`string`	—	The label name for the address to be linked to. It can also be set to the empty string "" to represent the default label. The label does not need to exist, it will be created if there is no label by the given name.
address_type	`string`	—	The address type to use. Options are "legacy", "p2sh-segwit", "bech32", and "bech32m". Does NOT support "v2" or witness v2.

Result

Type: any

"str" (string) The new bitcoin address

Source: services/core-node/bcore/src/wallet/rpc/addresses.cpp:21

C++ symbol: getnewaddress

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"getnewaddress","params":["","set by -addresstype"]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli getnewaddress

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getnewaddress", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8332/

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "getnewaddress",
        "params": ["", "set by -addresstype"],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "getnewaddress",
    params: ["","set by -addresstype"],
  }),
});
console.log(await res.json());