Node Info - Ralph Studio

The node info endpoints give you visibility into the state of the Alephium node app is connected to. Use these to check sync status, monitor hashrate, and verify network configuration.

Get node version

Returns the current version of the running node.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/version" \
  -H "Authorization: Bearer API_KEY"

{
  "version": "v4.5.1"
}

Get self clique info

Returns information about the node’s clique — its sync status, connected peers, and network position. This is the most useful endpoint for checking if the node is healthy.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/self-clique" \
  -H "Authorization: Bearer API_KEY"

{
  "cliqueId": "0268dbe...",
  "networkId": 0,
  "numZerosAtLeastInHash": 37,
  "nodes": [
    {
      "address": "127.0.0.1",
      "restPort": 12973,
      "wsPort": 11973,
      "minerApiPort": 10973
    }
  ],
  "selfReady": true,
  "synced": true,
  "groupNumPerBroker": 4,
  "groups": 4
}

synced: true means the node is caught up with the chain. If this is false the node is still syncing and responses may return stale data.

Get chain parameters

Returns network-level configuration parameters.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/chain-params" \
  -H "Authorization: Bearer API_KEY"

{
  "networkId": 0,
  "numZerosAtLeastInHash": 37,
  "groupNumPerBroker": 4,
  "groups": 4
}

networkId is 0 for mainnet and 1 for testnet.

Get current hashrate

Returns the current mining hashrate of the network.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/current-hashrate" \
  -H "Authorization: Bearer API_KEY"

{
  "hashrate": "6333680720 MH/s"
}

Get historical hashrate

Returns average hashrate over a time range. Timestamps are in milliseconds.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/history-hashrate?fromTs=1748476800000&toTs=1748480400000" \
  -H "Authorization: Bearer API_KEY"

{
  "hashrate": "6100000000 MH/s"
}

Get current difficulty

Returns the current mining difficulty.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/current-difficulty" \
  -H "Authorization: Bearer API_KEY"

{
  "difficulty": "11520765..."
}

Get node peers

Returns a list of peers the node is currently connected to.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/inter-clique-peer-info" \
  -H "Authorization: Bearer API_KEY"

[
  {
    "cliqueId": "0337ea...",
    "brokerId": 0,
    "groupNumPerBroker": 4,
    "address": {
      "addr": "173.234.30.37",
      "port": 9973
    },
    "isTrusted": false,
    "connectionType": "Outbound"
  }
]

Get discovered neighbors

Returns nodes discovered through the peer discovery protocol but not necessarily connected.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/discovered-neighbors" \
  -H "Authorization: Bearer API_KEY"

Get misbehaving peers

Returns peers that have been flagged for sending invalid data.

curl "https://rpc.ralphstudio.xyz/{slug}/infos/misbehaving-peers" \
  -H "Authorization: Bearer API_KEY"

Parameters reference

Parameter	Type	Description
fromTs	integer	Start timestamp in milliseconds
toTs	integer	End timestamp in milliseconds

​Get node version

​Get self clique info

​Get chain parameters

​Get current hashrate

​Get historical hashrate

​Get current difficulty

​Get node peers

​Get discovered neighbors

​Get misbehaving peers

​Parameters reference