server_state
Asks the server for machine-readable information about the rippled server's current state. The response is almost the same as server_info, but uses units that are easier to process. Clio forwards this call to the rippled it is connected to.
This method will use 20 Compute Units.
Reference: Here
Parameters
None
Returns
state(object) Server state information:build_version,complete_ledgers(the range held by rippled, not the Clio full-history range),io_latency_ms,jq_trans_overflow,last_close(converge_timein milliseconds andproposers),load_base,load_factorand the relatedload_factor_*fields,network_id,peers,ports,pubkey_node,server_state,server_state_duration_us,state_accounting,time,uptime,validated_ledger(base_fee,close_time,hash,reserve_base,reserve_inc,seq),validation_quorumandvalidator_list_expires.
// Result
{
"result": {
"state": {
"build_version": "3.4.0",
"complete_ledgers": "107059789-107292936",
"io_latency_ms": 1,
"jq_trans_overflow": "0",
"last_close": {
"converge_time": 3001,
"proposers": 34
},
"load_base": 256,
"load_factor": 256,
"load_factor_fee_escalation": 256,
"load_factor_fee_queue": 256,
"load_factor_fee_reference": 256,
"load_factor_server": 256,
"network_id": 0,
"node_size": "huge",
"peers": 22,
"ports": [
{
"port": "5005",
"protocol": [
"http"
]
},
// ...
],
"pubkey_node": "n9Km8nhtPLkfupADjSZKhiEpUTCaXYcxh3uWTCFVRmSxJrqnsozK",
"pubkey_validator": "none",
"server_state": "full",
"server_state_duration_us": "267443845853",
"state_accounting": {
"full": {
"duration_us": "267443845853",
"transitions": "1"
},
"syncing": {
"duration_us": "4071549",
"transitions": "1"
},
// ...
},
"time": "2026-Sep-28 12:49:22.774621 UTC",
"uptime": 267898,
"validated_ledger": {
"base_fee": 10,
"close_time": 843914960,
"hash": "925A0E8F39F21363E351A8F4551AEEC2751142B5997816FB722B7A1BF1D61F9A",
"reserve_base": 1000000,
"reserve_inc": 200000,
"seq": 107292936
},
"validation_quorum": 28,
"validator_list_expires": 860349094
},
"status": "success"
},
"status": "success",
"type": "response",
"forwarded": true
}Over WebSocket, send {"id":1,"command":"server_state"} to wss://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE>.
The example above is trimmed;
portsandstate_accountingare shortened and admin-only sections are omitted.
Last updated
Was this helpful?