Skip to main content

getnodeaddresses

getnodeaddresses ( count )

Return known addresses which can potentially be used to find new nodes in the network

Argument #1 - count​

Type: numeric, optional, default=1

The maximum number of addresses to return. Specify 0 to return all known addresses.

Result​

[                         (json array)
  {                       (json object)
    "time" : xxx,         (numeric) The UNIX epoch time of when the node was last seen
    "services" : n,       (numeric) The services offered
    "address" : "str",    (string) The address of the node
    "port" : n            (numeric) The port of the node
  },
  ...
]

Example usage (with RPC call)​

BGL-cli getnodeaddresses 8
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getnodeaddresses", "params": [8]}' -H 'content-type: text/plain;' http://127.0.0.1:8334/