Skip to main content

server_state

POST
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.
Responses
Detailed server state information.
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.
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.
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.
The list of ports the server is listening on.
portstring
The port number the server is listening on.
protocolarray
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.
The accumulated duration and transition count for each server state.
duration_usstring
The total time spent in that state, in microseconds.
transitionsstring
The number of transitions into that state.
timestring
The server's current time in UTC.
uptimeinteger
The time the server has been operating continuously, in seconds.
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.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "Unauthorized"
}
cURL
curl -X POST 'https://xrpl-mainnet.nodit.io' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "method": "server_state",
    "params": []
  }'