> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ralphstudio.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Node Info

> Query node version, sync status, network parameters, and hashrate.

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.

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

```json theme={null}
{
  "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.

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

```json theme={null}
{
  "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.

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

```json theme={null}
{
  "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.

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

```json theme={null}
{
  "hashrate": "6333680720 MH/s"
}
```

## Get historical hashrate

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

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

```json theme={null}
{
  "hashrate": "6100000000 MH/s"
}
```

## Get current difficulty

Returns the current mining difficulty.

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

```json theme={null}
{
  "difficulty": "11520765..."
}
```

## Get node peers

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

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

```json theme={null}
[
  {
    "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.

```bash theme={null}
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.

```bash theme={null}
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   |
