getnetworkinfo | Alchemy Docs

curl -X POST https://bitcoin-mainnet.g.alchemy.com/v2/{apiKey} \
     -H "Content-Type: application/json" \
     -d '{
  "jsonrpc": "2.0",
  "method": "getnetworkinfo",
  "params": [],
  "id": 1
}'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "version": 270000,
    "subversion": "/Satoshi:27.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [
      "NETWORK",
      "WITNESS",
      "NETWORK_LIMITED"
    ],
    "localrelay": true,
    "timeoffset": 0,
    "connections": 10,
    "connections_in": 2,
    "connections_out": 8,
    "networkactive": true,
    "networks": [
      {
        "name": "ipv4",
        "limited": false,
        "reachable": true,
        "proxy": "",
        "proxy_randomize_credentials": false
      },
      {
        "name": "ipv6",
        "limited": false,
        "reachable": true,
        "proxy": "",
        "proxy_randomize_credentials": false
      },
      {
        "name": "onion",
        "limited": true,
        "reachable": false,
        "proxy": "",
        "proxy_randomize_credentials": false
      }
    ],
    "relayfee": 0.00001,
    "incrementalfee": 0.00001,
    "localaddresses": [],
    "warnings": ""
  }
}

Returns an object containing various state info regarding P2P networking, including version information, network status, connections, and relay fees.

Path parameters

apiKeystringRequiredDefaults to docs-demo

Response

Object containing P2P networking state information.

versioninteger or null

The server version.

subversionstring or null

The server subversion string (e.g., “/Satoshi:x.x.x/”).

protocolversioninteger or null

The protocol version.

localservicesstring or null

The services we offer to the network (hex string).

localservicesnameslist of strings or null

List of network services offered.

localrelayboolean or null

True if transaction relay is requested from peers.

timeoffsetinteger or null

The time offset in seconds.

connectionsinteger or null

The total number of connections.

connections_ininteger or null

The number of inbound connections.

connections_outinteger or null

The number of outbound connections.

networkactiveboolean or null

Whether P2P networking is enabled.

networkslist of objects or null

Information per network.

relayfeedouble or null

Minimum relay fee for transactions in BTC/kvB.

incrementalfeedouble or null

Minimum fee increment for mempool limiting or BIP 125 replacement in BTC/kvB.

localaddresseslist of objects or null

List of local addresses.

warningsstring or null

Any network and blockchain warnings.