getnodeaddresses

Back to network

Summary

Return known addresses, after filtering for quality and recency.

Description

Return known addresses, after filtering for quality and recency. These can potentially be used to find new peers in the network. The total number of addresses known to the node may be higher.

Arguments

• count (NUM): The maximum number of addresses to return. Specify 0 to return all known addresses.
• network (STR): Return only addresses of the specified network. Can be one of: ipv4, ipv6, onion, i2p, cjdns.

Results

• value (ARR): No description.
• value (OBJ): No description.
  • time (NUM_TIME): The UNIX epoch time when the node was last seen
  • services (NUM): The services offered by the node
  • address (STR): The address of the node
  • port (NUM): The port number of the node
  • network (STR): The network (ipv4, ipv6, onion, i2p, cjdns) the node connected through

Examples

qbit-cli getnodeaddresses 8

qbit-cli getnodeaddresses 4 "i2p"

qbit-cli -named getnodeaddresses network=onion count=12

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

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