Console

POSTserver_state

XRP Ledger Mainnethttps://xrpl-mainnet.nodit.io/

Returns server state information in a machine-readable form. It provides the same information as server_info, but the values are returned as raw integers and strings.

Request Body
methodstringrequired
paramsobject[]required

This method takes no parameters. Pass an empty array.

Responses
amendment_blockedboolean

Whether the server is amendment blocked. Returned only in that state.

build_versionstring

The version of the running server.

complete_ledgersstring

The range of ledger indexes the server holds.

closed_ledgerobject

A summary of a ledger version as the server sees it.

base_feenumber

The reference transaction cost, in XRP.

close_timenumber

The time the ledger closed, in seconds since the Ripple Epoch.

hashstring

The unique hash that identifies the ledger version.

reserve_basenumber

The minimum reserve required to keep an account, in XRP.

reserve_incnumber

The additional reserve required per ledger object, in XRP.

seqinteger

The ledger index.

io_latency_msinteger

The I/O wait time, in milliseconds.

jq_trans_overflowstring

The number of times the transaction queue has overflowed.

last_closeobject

Consensus information from the previous ledger close.

converge_timeinteger

The time taken to reach consensus, in milliseconds.

proposersinteger

The number of validators that participated in consensus.

load_baseinteger

The baseline server load used for cost calculations.

load_factorinteger

The load multiplier currently in effect.

load_factor_fee_escalationinteger

The cost multiplier for inclusion in the open ledger.

load_factor_fee_queueinteger

The cost multiplier for entering the queue.

load_factor_fee_referenceinteger

The reference transaction cost without any multiplier applied.

load_factor_serverinteger

The load multiplier the server enforces.

peersinteger

The number of connected peer servers.

portsobject[]

The list of ports the server is listening on.

portstring

The port number the server is listening on.

protocolstring[]

The list of protocols served on that port.

pubkey_nodestring

The public key used to verify peer-to-peer communication.

server_statestring

The server's level of participation in the network.

server_state_duration_usstring

The time spent in the current state, in microseconds.

state_accountingobject

The accumulated duration and transition count for each server state.

timestring

The server's current time in UTC.

uptimeinteger

The time the server has been operating continuously, in seconds.

validated_ledgerobject

A summary of a ledger version as the server sees it.

base_feenumber

The reference transaction cost, in XRP.

close_timenumber

The time the ledger closed, in seconds since the Ripple Epoch.

hashstring

The unique hash that identifies the ledger version.

reserve_basenumber

The minimum reserve required to keep an account, in XRP.

reserve_incnumber

The additional reserve required per ledger object, in XRP.

seqinteger

The ledger index.

validation_quoruminteger

The number of trusted validations required to validate a ledger version.

X-API-KEY
RequestCU15
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "server_state",
  "params": []
}'
Response
Example · 200
{
  "result": {
    "state": {
      "build_version": "2.5.0",
      "complete_ledgers": "32570-98765432",
      "io_latency_ms": 1,
      "jq_trans_overflow": "0",
      "last_close": {
        "converge_time": 3002,
        "proposers": 35
      },
      "load_base": 256,
      "load_factor": 256,
      "peers": 21,
      "pubkey_node": "n9KUjqxCr5FKThSNXdzb7oqN8rYwScB2dUnNqxQxbEA17JkaWy5x",
      "server_state": "full",
      "server_state_duration_us": "8004784090",
      "time": "2026-Sep-02 04:12:33.482745 UTC",
      "uptime": 8005,
      "validated_ledger": {
        "base_fee": 10,
        "close_time": 810900000,
        "hash": "17ACB57A0F73B5160713E81FE72B2AC9F6064541004E272BD09F257D57C30C02",
        "reserve_base": 1000000,
        "reserve_inc": 200000,
        "seq": 98765432
      },
      "validation_quorum": 28
    }
  }
}

Last updated