Skip to content

getnodeaddresses JSON-RPC command

getnodeaddresses ( count )

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


1. count    (numeric, optional, default=1) How many addresses to return. Limited to the smaller of 2500 or 23% of all known addresses.


    "time": ttt,                (numeric) Timestamp in seconds since epoch (Jan 1 1970 GMT) keeping track of when the node was last seen
    "services": n,              (numeric) The services offered
    "address": "host",          (string) The address of the node
    "port": n                   (numeric) The port of the node


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

Bitcoin Cash Node Daemon version v23.0.1-ad76493

Documentation on reflects the current master branch in Git, and may include API changes that are not yet present in the latest release.