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

# GET /getinfo — Daemon Status and Network Info

> Retrieve node status, block height, peer count, difficulty, mempool depth, and top block hash from the Fuego daemon using a simple HTTP GET request.

The `/getinfo` endpoint is your primary health-check and status probe for a running Fuego daemon. It returns a comprehensive snapshot of the node's view of the network: the current block height, live difficulty, mempool depth, peer counts, and the top block hash. You call it with a plain HTTP `GET` — no request body required — making it easy to integrate into monitoring scripts, dashboards, or node-selection logic.

## GET /getinfo

**URL:** `http://127.0.0.1:18180/getinfo`

```bash theme={null}
curl http://127.0.0.1:18180/getinfo
```

**Example response:**

```json theme={null}
{
  "status": "OK",
  "version": "6.1.0",
  "height": 900000,
  "difficulty": 12345678,
  "tx_count": 4200000,
  "tx_pool_size": 3,
  "alt_blocks_count": 0,
  "outgoing_connections_count": 8,
  "incoming_connections_count": 2,
  "white_peerlist_size": 120,
  "grey_peerlist_size": 480,
  "last_known_block_index": 899999,
  "top_block_hash": "a1b2c3d4e5f6...",
  "fee_address": "fire1XfG...",
  "block_major_version": 9,
  "block_minor_version": 0,
  "full_deposit_amount": 8000000000000,
  "last_block_reward": 180000000,
  "last_block_timestamp": 1712345678,
  "last_block_difficulty": 12300000,
  "connections": ["1.2.3.4:10808", "5.6.7.8:10808"]
}
```

### Response Fields

<ResponseField name="status" type="string" required>
  `"OK"` when the daemon is healthy. `"BUSY"` if the core is still initializing.
</ResponseField>

<ResponseField name="version" type="string" required>
  Daemon version string (e.g. `"6.1.0"`).
</ResponseField>

<ResponseField name="height" type="integer" required>
  Current blockchain height as seen by this node — the index of the last block in the main chain.
</ResponseField>

<ResponseField name="difficulty" type="integer" required>
  Current network mining difficulty.
</ResponseField>

<ResponseField name="tx_count" type="integer" required>
  Total number of transactions ever confirmed on the chain (excludes coinbase transactions).
</ResponseField>

<ResponseField name="tx_pool_size" type="integer" required>
  Number of transactions currently in the mempool waiting to be included in a block.
</ResponseField>

<ResponseField name="alt_blocks_count" type="integer" required>
  Number of alternative (orphaned) blocks the node is currently tracking.
</ResponseField>

<ResponseField name="outgoing_connections_count" type="integer" required>
  Number of outbound P2P connections the daemon has established.
</ResponseField>

<ResponseField name="incoming_connections_count" type="integer" required>
  Number of inbound P2P connections from remote peers.
</ResponseField>

<ResponseField name="white_peerlist_size" type="integer" required>
  Number of peers in the white (trusted/recently-seen) peer list.
</ResponseField>

<ResponseField name="grey_peerlist_size" type="integer" required>
  Number of peers in the grey (candidate) peer list.
</ResponseField>

<ResponseField name="last_known_block_index" type="integer" required>
  The highest block index that this node is aware of from its peers. May be higher than `height` during sync.
</ResponseField>

<ResponseField name="top_block_hash" type="string" required>
  Hex-encoded hash of the most recent block in the main chain.
</ResponseField>

<ResponseField name="fee_address" type="string">
  The node operator's fee address, if configured with `--fee-address`. Empty string if not set.
</ResponseField>

<ResponseField name="block_major_version" type="integer" required>
  Major version of the current block format (9 = Godflame/Fuego era, active from height 826420).
</ResponseField>

<ResponseField name="block_minor_version" type="integer" required>
  Minor version of the current block format.
</ResponseField>

<ResponseField name="full_deposit_amount" type="integer" required>
  Total XFG currently locked in deposits across the network, in atomic units.
</ResponseField>

<ResponseField name="last_block_reward" type="integer" required>
  Block reward paid for the most recent block, in atomic units.
</ResponseField>

<ResponseField name="last_block_timestamp" type="integer" required>
  Unix timestamp of the most recent block.
</ResponseField>

<ResponseField name="last_block_difficulty" type="integer" required>
  Difficulty at the time the most recent block was mined.
</ResponseField>

<ResponseField name="connections" type="array of strings">
  List of currently connected peer addresses in `"ip:port"` format.
</ResponseField>

***

## GET /getheight

Returns only the current block height. Useful for lightweight polling.

**URL:** `http://127.0.0.1:18180/getheight`

```bash theme={null}
curl http://127.0.0.1:18180/getheight
```

**Example response:**

```json theme={null}
{
  "height": 900000,
  "status": "OK"
}
```

<ResponseField name="height" type="integer" required>
  Current blockchain height.
</ResponseField>

<ResponseField name="status" type="string" required>
  `"OK"` on success.
</ResponseField>

***

## GET /getpeers

Returns the list of peers the daemon is currently connected to.

**URL:** `http://127.0.0.1:18180/getpeers`

```bash theme={null}
curl http://127.0.0.1:18180/getpeers
```

**Example response:**

```json theme={null}
{
  "peers": [
    "3.16.217.33:10808",
    "80.89.228.157:10808",
    "207.244.247.64:10808"
  ],
  "status": "OK"
}
```

<ResponseField name="peers" type="array of strings" required>
  List of peer addresses in `"ip:port"` format that the daemon currently knows about.
</ResponseField>

<ResponseField name="status" type="string" required>
  `"OK"` on success.
</ResponseField>