getaddednodeinfo (network command)

Bitcoin Core 27.0 RPC

getaddednodeinfo ( "node" )

Returns information about the given added node, or all added nodes

(note that onetry addnodes are not listed here)

Arguments

1. node    (string, optional, default=all nodes) If provided, return information about this specific node, otherwise all nodes are returned.

Result

[                                (json array)
  {                              (json object)
    "addednode" : "str",         (string) The node IP address or name (as provided to addnode)
    "connected" : true|false,    (boolean) If connected
    "addresses" : [              (json array) Only when connected = true
      {                          (json object)
        "address" : "str",       (string) The bitcoin server IP and port we're connected to
        "connected" : "str"      (string) connection, inbound or outbound
      },
      ...
    ]
  },
  ...
]

Examples

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