Skip to main content
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 
curl http://127.0.0.1:18180/getinfo
Example response: 
{
  "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

​
status
string
required
"OK" when the daemon is healthy. "BUSY" if the core is still initializing.
​
version
string
required
Daemon version string (e.g. "6.1.0").
​
height
integer
required
Current blockchain height as seen by this node — the index of the last block in the main chain.
​
difficulty
integer
required
Current network mining difficulty.
​
tx_count
integer
required
Total number of transactions ever confirmed on the chain (excludes coinbase transactions).
​
tx_pool_size
integer
required
Number of transactions currently in the mempool waiting to be included in a block.
​
alt_blocks_count
integer
required
Number of alternative (orphaned) blocks the node is currently tracking.
​
outgoing_connections_count
integer
required
Number of outbound P2P connections the daemon has established.
​
incoming_connections_count
integer
required
Number of inbound P2P connections from remote peers.
​
white_peerlist_size
integer
required
Number of peers in the white (trusted/recently-seen) peer list.
​
grey_peerlist_size
integer
required
Number of peers in the grey (candidate) peer list.
​
last_known_block_index
integer
required
The highest block index that this node is aware of from its peers. May be higher than height during sync.
​
top_block_hash
string
required
Hex-encoded hash of the most recent block in the main chain.
​
fee_address
string
The node operator’s fee address, if configured with --fee-address. Empty string if not set.
​
block_major_version
integer
required
Major version of the current block format (9 = Godflame/Fuego era, active from height 826420).
​
block_minor_version
integer
required
Minor version of the current block format.
​
full_deposit_amount
integer
required
Total XFG currently locked in deposits across the network, in atomic units.
​
last_block_reward
integer
required
Block reward paid for the most recent block, in atomic units.
​
last_block_timestamp
integer
required
Unix timestamp of the most recent block.
​
last_block_difficulty
integer
required
Difficulty at the time the most recent block was mined.
​
connections
array of strings
List of currently connected peer addresses in "ip:port" format.

​
GET /getheight

Returns only the current block height. Useful for lightweight polling. URL: http://127.0.0.1:18180/getheight 
curl http://127.0.0.1:18180/getheight
Example response: 
{
  "height": 900000,
  "status": "OK"
}
​
height
integer
required
Current blockchain height.
​
status
string
required
"OK" on success.

​
GET /getpeers

Returns the list of peers the daemon is currently connected to. URL: http://127.0.0.1:18180/getpeers 
curl http://127.0.0.1:18180/getpeers
Example response: 
{
  "peers": [
    "3.16.217.33:10808",
    "80.89.228.157:10808",
    "207.244.247.64:10808"
  ],
  "status": "OK"
}
​
peers
array of strings
required
List of peer addresses in "ip:port" format that the daemon currently knows about.
​
status
string
required
"OK" on success.