getnodeaddresses | Bitcoin

POST /788f110831fe13808302bd79796d55e8

getnodeaddresses

cURL

curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "1.0",
  "method": "getnodeaddresses",
  "params": [
    0
  ],
  "id": 1
}
'

200

{
  "result": [
    {
      "address": "<string>",
      "port": 123,
      "services": "<string>",
      "time": 123
    }
  ],
  "error": {},
  "id": 123
}

The getnodeaddresses method retrieves known addresses of network peers. This can be particularly useful for new nodes looking to find peers to connect to for initial blockchain synchronization.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

• count (optional): The number of addresses to return. Specifying 0 will return all known addresses.

Response

• result — an array of objects, each representing a known peer address. Each object includes the address, port, services offered by the peer, and the last time the address was seen.
• error — an object containing an error message if an error occurred, otherwise null.
• id — an integer representing the ID of the request.

Use case

The getnodeaddresses method is useful for bootstrapping or maintaining a healthy list of peers, ensuring a node has multiple avenues for connecting and synchronizing with the network.

Body

application/json

jsonrpc · string · default: 1.0

method · string · default: getnodeaddresses

params · integer[]

The number of addresses to return. If 0 is specified, the node will return all known addresses.

id · integer · default: 1

Response

200 - application/json

A list of known network peer addresses.

result · object[]

Show child attributes

error · object

id · integer