---
updatedAt: 2026-09-08T10:21:10.000Z
agentTools:
  projectIndex: https://developers.tron.network/llms.txt
---

# GetNodeInfo

Query Node Information. Returns information about current state of node. (solidified state)

## Related resources

* [Getburntrx 1](https://developers.tron.network/reference/getburntrx-1) — next in this section

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "full-node-http-api",
    "version": "4.8.0"
  },
  "servers": [
    {
      "url": "https://api.shasta.trongrid.io",
      "description": "Shasta Testnet"
    },
    {
      "url": "https://nile.trongrid.io",
      "description": "Nile Testnet"
    },
    {
      "url": "https://api.trongrid.io",
      "description": "Mainnet (real assets)"
    }
  ],
  "components": {
    "schemas": {
      "NodeHttpBusinessError": {
        "title": "Error",
        "type": "object",
        "description": "When request processing fails, java-tron may return this format with HTTP 200; the `Error` field contains the error details.",
        "required": [
          "Error"
        ],
        "properties": {
          "Error": {
            "type": "string",
            "description": "Error text returned by java-tron."
          }
        },
        "examples": [
          {
            "Error": "Invalid request parameters."
          }
        ],
        "additionalProperties": false
      },
      "PeerInfo": {
        "type": "object",
        "description": "P2P peer connection info, returned by node-info endpoints.",
        "properties": {
          "lastSyncBlock": {
            "type": "string"
          },
          "remainNum": {
            "type": "integer",
            "format": "int64"
          },
          "lastBlockUpdateTime": {
            "type": "integer",
            "format": "int64"
          },
          "syncFlag": {
            "type": "boolean"
          },
          "headBlockTimeWeBothHave": {
            "type": "integer",
            "format": "int64"
          },
          "needSyncFromPeer": {
            "type": "boolean"
          },
          "needSyncFromUs": {
            "type": "boolean"
          },
          "host": {
            "type": "string"
          },
          "port": {
            "type": "integer",
            "format": "int32"
          },
          "nodeId": {
            "type": "string"
          },
          "connectTime": {
            "type": "integer",
            "format": "int64"
          },
          "avgLatency": {
            "type": "number",
            "format": "double"
          },
          "syncToFetchSize": {
            "type": "integer",
            "format": "int32"
          },
          "syncToFetchSizePeekNum": {
            "type": "integer",
            "format": "int64"
          },
          "syncBlockRequestedSize": {
            "type": "integer",
            "format": "int32"
          },
          "unFetchSynNum": {
            "type": "integer",
            "format": "int64"
          },
          "blockInPorcSize": {
            "type": "integer",
            "format": "int32"
          },
          "headBlockWeBothHave": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "score": {
            "type": "integer",
            "format": "int32"
          },
          "nodeCount": {
            "type": "integer",
            "format": "int32"
          },
          "inFlow": {
            "type": "integer",
            "format": "int64"
          },
          "disconnectTimes": {
            "type": "integer",
            "format": "int32"
          },
          "localDisconnectReason": {
            "type": "string"
          },
          "remoteDisconnectReason": {
            "type": "string"
          }
        }
      },
      "ConfigNodeInfo": {
        "type": "object",
        "description": "Node configuration parameters (genesis, network, db, p2p, vm).",
        "properties": {
          "codeVersion": {
            "type": "string"
          },
          "versionNum": {
            "type": "string"
          },
          "p2pVersion": {
            "type": "string"
          },
          "listenPort": {
            "type": "integer",
            "format": "int32"
          },
          "discoverEnable": {
            "type": "boolean"
          },
          "activeNodeSize": {
            "type": "integer",
            "format": "int32"
          },
          "passiveNodeSize": {
            "type": "integer",
            "format": "int32"
          },
          "sendNodeSize": {
            "type": "integer",
            "format": "int32"
          },
          "maxConnectCount": {
            "type": "integer",
            "format": "int32"
          },
          "sameIpMaxConnectCount": {
            "type": "integer",
            "format": "int32"
          },
          "backupListenPort": {
            "type": "integer",
            "format": "int32"
          },
          "backupMemberSize": {
            "type": "integer",
            "format": "int32"
          },
          "backupPriority": {
            "type": "integer",
            "format": "int32"
          },
          "dbVersion": {
            "type": "integer",
            "format": "int32"
          },
          "minParticipationRate": {
            "type": "integer",
            "format": "int32"
          },
          "supportConstant": {
            "type": "boolean"
          },
          "minTimeRatio": {
            "type": "number",
            "format": "double"
          },
          "maxTimeRatio": {
            "type": "number",
            "format": "double"
          },
          "allowCreationOfContracts": {
            "type": "integer",
            "format": "int64"
          },
          "allowAdaptiveEnergy": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "MachineInfo": {
        "type": "object",
        "description": "Host machine info (memory, CPU, JVM heap, disk).",
        "properties": {
          "threadCount": {
            "type": "integer",
            "format": "int32"
          },
          "deadLockThreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "cpuCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalMemory": {
            "type": "integer",
            "format": "int64"
          },
          "freeMemory": {
            "type": "integer",
            "format": "int64"
          },
          "cpuRate": {
            "type": "number",
            "format": "double"
          },
          "javaVersion": {
            "type": "string"
          },
          "osName": {
            "type": "string"
          },
          "jvmTotalMemory": {
            "type": "integer",
            "format": "int64"
          },
          "jvmFreeMemory": {
            "type": "integer",
            "format": "int64"
          },
          "processCpuRate": {
            "type": "number",
            "format": "double"
          },
          "memoryDescInfoList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MemoryDescInfo"
            }
          },
          "deadLockThreadInfoList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeadLockThreadInfo"
            }
          }
        }
      },
      "MemoryDescInfo": {
        "type": "object",
        "description": "JVM memory-pool usage.",
        "properties": {
          "name": {
            "type": "string"
          },
          "initSize": {
            "type": "integer",
            "format": "int64"
          },
          "useSize": {
            "type": "integer",
            "format": "int64"
          },
          "maxSize": {
            "type": "integer",
            "format": "int64"
          },
          "useRate": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "DeadLockThreadInfo": {
        "type": "object",
        "description": "JVM deadlocked-thread details.",
        "properties": {
          "name": {
            "type": "string"
          },
          "lockName": {
            "type": "string"
          },
          "lockOwner": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "blockTime": {
            "type": "integer",
            "format": "int64"
          },
          "waitTime": {
            "type": "integer",
            "format": "int64"
          },
          "stackTrace": {
            "type": "string"
          }
        }
      }
    }
  },
  "security": [
    {}
  ],
  "paths": {
    "/walletsolidity/getnodeinfo": {
      "get": {
        "summary": "GetNodeInfo",
        "description": "Query Node Information. Returns information about current state of node. (Confirmed state)",
        "operationId": "getnodeinfo-1",
        "responses": {
          "200": {
            "description": "When the request completes normally, the response body contains the endpoint result. If request processing raises an exception, the HTTP status may still be 200; in that case, the response body contains only the `Error` field.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "title": "Result",
                      "not": {
                        "type": "object",
                        "required": [
                          "Error"
                        ]
                      },
                      "type": "object",
                      "properties": {
                        "beginSyncNum": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Starting block number for synchronization."
                        },
                        "block": {
                          "type": "string",
                          "description": "Latest block information, including height and ID."
                        },
                        "solidityBlock": {
                          "type": "string",
                          "description": "Latest solidified block information, including height and ID."
                        },
                        "currentConnectCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "Current number of node connections."
                        },
                        "activeConnectCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "Number of active node connections."
                        },
                        "passiveConnectCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "Number of passive node connections."
                        },
                        "totalFlow": {
                          "type": "integer",
                          "format": "int64",
                          "description": "Total TCP flow."
                        },
                        "peerList": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/PeerInfo"
                          },
                          "description": "Peer node information. See [protobuf](https://github.com/tronprotocol/java-tron/blob/develop/protocol/src/main/protos/core/Tron.proto) for details."
                        },
                        "configNodeInfo": {
                          "$ref": "#/components/schemas/ConfigNodeInfo",
                          "description": "Node configuration information, please refer to [protobuf](https://github.com/tronprotocol/java-tron/blob/develop/protocol/src/main/protos/core/Tron.proto) for details."
                        },
                        "machineInfo": {
                          "$ref": "#/components/schemas/MachineInfo",
                          "description": "Information about the machine running the node."
                        },
                        "cheatWitnessInfoMap": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "string"
                          },
                          "description": "Information about Super Representatives (SRs) suspected of cheating."
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/NodeHttpBusinessError"
                    }
                  ]
                },
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```