Parameters

object

object

REQUIRED

The server_state request object.

Returns

result

object

An object which contains the following fields:

state

object

The details of the server state, including:

build_version

string

The version of the server

complete_ledgers

string

It is a range expression which indicate the sequence numbers of the ledger versions

initial_sync_duration_us

string

The duration of initial sync

io_latency_ms

integer

The amount of time spent waiting for I/O operations

jq_trans_overflow

string

The number of times (since starting up) that this server has had over 250 transactions waiting to be processed at once

last_close

object

The information about the last time the server closed a ledger

converge_time_s

integer

The amount of time it took to reach a consensus on the most recently validated ledger version, in seconds

proposers

integer

The number of trusted validators the server considered (including itself)

load

object

The detailed information about the current load state of the server (Admin only)

job_types

array

It gives information about the rate of different types of jobs the server is doing and how much time it spends on each

in_progress

integer

The number of jobs in progress

job_type

string

The job type

threads

integer

The number of threads in the server's main job pool

load_base

integer

The baseline amount of server load used in transaction cost calculations

load_factor

integer

The load factor the server is currently enforcing

load_factor_fee_escalation

integer

The current multiplier to the transaction cost to get into the open ledger, in fee levels

load_factor_fee_queue

integer

he current multiplier to the transaction cost to get into the queue

load_factor_fee_reference

integer

The transaction cost with no load scaling

load_factor_server

integer

The load factor server value

network_id

integer

The network ID

peer_disconnects

string

The number of peer disconnections that have occurred

peer_disconnects_resources

string

The number of peer disconnections due to resource constraints

peers

integer

The number of other rippled servers this server is currently connected to

pubkey_node

string

The public key used to verify this server for peer-to-peer communications

server_state

string

A string indicating to what extent the server is participating in the network

server_state_duration_us

string

The number of consecutive microseconds the server has been in the current state

state_accounting

object

A map of various server states with information about the time the server spends in each

connected

object

An object which give information about when the server was connected

duration_us

string

The number of microseconds the server has spent in connected state

transitions

string

The number of times the server has changed into connected state

disconnected

object

An object which give information about when the server was disconnected

duration_us

string

The number of microseconds the server has spent in disconnected state

transitions

string

The number of times the server has changed into disconnected state

full

object

An object which give information about when the server was full

duration_us

string

The number of microseconds the server has spent in full state

transitions

string

The number of times the server has changed into full state

syncing

object

An object which give information about when the server was syncing

duration_us

string

The number of microseconds the server has spent in syncing state

transitions

string

The number of times the server has changed into syncing state

tracking

object

An object which give information about when the server was tracking

duration_us

string

The number of microseconds the server has spent in tracking state

transitions

string

The number of times the server has changed into tracking state

time

string

The current time in UTC

uptime

integer

The number of consecutive seconds that the server has been operational

validated_ledger

object

It gives information about the most recent fully-validated ledger

age

integer

The time since the ledger was closed, in seconds

hash

string

The unique hash for the ledger, as hexadecimal

seq

integer

The ledger index of the latest validated ledger

base_fee_xrp

integer

The base fee for transactions in drops of XRP

reserve_base_xrp

integer

The minimum amount of XRP (not drops) necessary for every account to keep in reserve

reserve_inc_xrp

integer

The amount of XRP (not drops) added to the account reserve for each object an account owns in the ledger

validation_quorum

integer

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

validator_list_expires

integer

The expiration timestamp of the validator list

status

string

The status of the server state request

type

string

(Optional) The type of response being received

forwarded

boolean

(Optional) When set to true, indicates that the transaction has been relayed or forwarded through intermediary nodes

warnings

array

(Optional) An array of warning objects, each containing the following fields. Returned at the JSON-RPC response root on some servers and omitted from the result object

id

integer

The ID of the warning

message

string

The warning message

Request

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "server_state",
6
  "params": [
7
    null
8
  ],
9
  "id": 1
10
}'

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "server_state",
6
  "params": [
7
    null
8
  ],
9
  "id": 1
10
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'server_state',
4
    params: [null],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'server_state',
4
    params: [null],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "server_state",
9
  "params": [
10
    None
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "server_state",
9
  "params": [
10
    None
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "server_state",
11
  params: [nil]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "server_state",
11
  params: [nil]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "result": {
3
    "state": {
4
      "build_version": "3.1.0",
5
      "complete_ledgers": "102425420-102609807",
6
      "git": {
7
        "branch": "HEAD",
8
        "hash": "d325f20c76fa798d0286d25e80b126ec0a2ee679"
9
      },
10
      "initial_sync_duration_us": "105962898",
11
      "io_latency_ms": 1,
12
      "jq_trans_overflow": "0",
13
      "last_close": {
14
        "converge_time": 2001,
15
        "proposers": 35
16
      },
17
      "load": {
18
        "job_types": [
19
          {
20
            "job_type": "clientFeeChange",
21
            "per_second": 18
22
          },
23
          {
24
            "in_progress": 1,
25
            "job_type": "clientWebsocket",
26
            "peak_time": 2,
27
            "per_second": 27
28
          },
29
          {
30
            "job_type": "untrustedValidation",
31
            "per_second": 17
32
          },
33
          {
34
            "job_type": "ledgerRequest",
35
            "peak_time": 3,
36
            "per_second": 5
37
          },
38
          {
39
            "job_type": "transaction",
40
            "per_second": 18
41
          },
42
          {
43
            "job_type": "batch",
44
            "per_second": 17
45
          },
46
          {
47
            "job_type": "ledgerData",
48
            "peak_time": 7
49
          },
50
          {
51
            "avg_time": 2,
52
            "job_type": "advanceLedger",
53
            "peak_time": 75,
54
            "per_second": 1
55
          },
56
          {
57
            "job_type": "fetchTxnData",
58
            "per_second": 8
59
          },
60
          {
61
            "job_type": "trustedValidation",
62
            "per_second": 4
63
          },
64
          {
65
            "job_type": "trustedProposal",
66
            "per_second": 14
67
          },
68
          {
69
            "job_type": "peerCommand",
70
            "per_second": 1204
71
          },
72
          {
73
            "job_type": "processTransaction",
74
            "per_second": 20
75
          },
76
          {
77
            "job_type": "SyncReadNode",
78
            "per_second": 42
79
          },
80
          {
81
            "job_type": "AsyncReadNode",
82
            "per_second": 59
83
          },
84
          {
85
            "job_type": "WriteNode",
86
            "per_second": 312
87
          }
88
        ],
89
        "threads": 32
90
      },
91
      "load_base": 256,
92
      "load_factor": 256,
93
      "load_factor_fee_escalation": 256,
94
      "load_factor_fee_queue": 256,
95
      "load_factor_fee_reference": 256,
96
      "load_factor_server": 256,
97
      "network_id": 0,
98
      "node_size": "huge",
99
      "peer_disconnects": "28359",
100
      "peer_disconnects_resources": "34",
101
      "peers": 21,
102
      "ports": [
103
        {
104
          "port": "51235",
105
          "protocol": [
106
            "peer"
107
          ]
108
        },
109
        {
110
          "port": "5005",
111
          "protocol": [
112
            "http"
113
          ]
114
        },
115
        {
116
          "port": "6006",
117
          "protocol": [
118
            "ws"
119
          ]
120
        },
121
        {
122
          "port": "50051",
123
          "protocol": [
124
            "grpc"
125
          ]
126
        }
127
      ],
128
      "pubkey_node": "n9J5wAr5zvJCnnYKjcv6xZJ5wVs7eCeHT5SmP28JTHyQZ3yAqFx3",
129
      "pubkey_validator": "none",
130
      "server_state": "full",
131
      "server_state_duration_us": "1852637335383",
132
      "state_accounting": {
133
        "connected": {
134
          "duration_us": "46063124",
135
          "transitions": "2"
136
        },
137
        "disconnected": {
138
          "duration_us": "54847364",
139
          "transitions": "2"
140
        },
141
        "full": {
142
          "duration_us": "1852637335383",
143
          "transitions": "1"
144
        },
145
        "syncing": {
146
          "duration_us": "5052400",
147
          "transitions": "1"
148
        },
149
        "tracking": {
150
          "duration_us": "8",
151
          "transitions": "1"
152
        }
153
      },
154
      "time": "2026-Mar-03 03:04:47.516196 UTC",
155
      "uptime": 1852743,
156
      "validated_ledger": {
157
        "base_fee": 10,
158
        "close_time": 825822281,
159
        "hash": "239AEF90407AA56065E9BCA6D52D21C187FB98B47B541ACC942D636801B71E0D",
160
        "reserve_base": 1000000,
161
        "reserve_inc": 200000,
162
        "seq": 102609807
163
      },
164
      "validation_quorum": 28,
165
      "validator_list_expires": 832615656
166
    },
167
    "status": "success"
168
  },
169
  "status": "success",
170
  "type": "response",
171
  "forwarded": true,
172
  "warnings": [
173
    {
174
      "id": 2001,
175
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
176
    }
177
  ]
178
}

1
{
2
  "result": {
3
    "state": {
4
      "build_version": "3.1.0",
5
      "complete_ledgers": "102425420-102609807",
6
      "git": {
7
        "branch": "HEAD",
8
        "hash": "d325f20c76fa798d0286d25e80b126ec0a2ee679"
9
      },
10
      "initial_sync_duration_us": "105962898",
11
      "io_latency_ms": 1,
12
      "jq_trans_overflow": "0",
13
      "last_close": {
14
        "converge_time": 2001,
15
        "proposers": 35
16
      },
17
      "load": {
18
        "job_types": [
19
          {
20
            "job_type": "clientFeeChange",
21
            "per_second": 18
22
          },
23
          {
24
            "in_progress": 1,
25
            "job_type": "clientWebsocket",
26
            "peak_time": 2,
27
            "per_second": 27
28
          },
29
          {
30
            "job_type": "untrustedValidation",
31
            "per_second": 17
32
          },
33
          {
34
            "job_type": "ledgerRequest",
35
            "peak_time": 3,
36
            "per_second": 5
37
          },
38
          {
39
            "job_type": "transaction",
40
            "per_second": 18
41
          },
42
          {
43
            "job_type": "batch",
44
            "per_second": 17
45
          },
46
          {
47
            "job_type": "ledgerData",
48
            "peak_time": 7
49
          },
50
          {
51
            "avg_time": 2,
52
            "job_type": "advanceLedger",
53
            "peak_time": 75,
54
            "per_second": 1
55
          },
56
          {
57
            "job_type": "fetchTxnData",
58
            "per_second": 8
59
          },
60
          {
61
            "job_type": "trustedValidation",
62
            "per_second": 4
63
          },
64
          {
65
            "job_type": "trustedProposal",
66
            "per_second": 14
67
          },
68
          {
69
            "job_type": "peerCommand",
70
            "per_second": 1204
71
          },
72
          {
73
            "job_type": "processTransaction",
74
            "per_second": 20
75
          },
76
          {
77
            "job_type": "SyncReadNode",
78
            "per_second": 42
79
          },
80
          {
81
            "job_type": "AsyncReadNode",
82
            "per_second": 59
83
          },
84
          {
85
            "job_type": "WriteNode",
86
            "per_second": 312
87
          }
88
        ],
89
        "threads": 32
90
      },
91
      "load_base": 256,
92
      "load_factor": 256,
93
      "load_factor_fee_escalation": 256,
94
      "load_factor_fee_queue": 256,
95
      "load_factor_fee_reference": 256,
96
      "load_factor_server": 256,
97
      "network_id": 0,
98
      "node_size": "huge",
99
      "peer_disconnects": "28359",
100
      "peer_disconnects_resources": "34",
101
      "peers": 21,
102
      "ports": [
103
        {
104
          "port": "51235",
105
          "protocol": [
106
            "peer"
107
          ]
108
        },
109
        {
110
          "port": "5005",
111
          "protocol": [
112
            "http"
113
          ]
114
        },
115
        {
116
          "port": "6006",
117
          "protocol": [
118
            "ws"
119
          ]
120
        },
121
        {
122
          "port": "50051",
123
          "protocol": [
124
            "grpc"
125
          ]
126
        }
127
      ],
128
      "pubkey_node": "n9J5wAr5zvJCnnYKjcv6xZJ5wVs7eCeHT5SmP28JTHyQZ3yAqFx3",
129
      "pubkey_validator": "none",
130
      "server_state": "full",
131
      "server_state_duration_us": "1852637335383",
132
      "state_accounting": {
133
        "connected": {
134
          "duration_us": "46063124",
135
          "transitions": "2"
136
        },
137
        "disconnected": {
138
          "duration_us": "54847364",
139
          "transitions": "2"
140
        },
141
        "full": {
142
          "duration_us": "1852637335383",
143
          "transitions": "1"
144
        },
145
        "syncing": {
146
          "duration_us": "5052400",
147
          "transitions": "1"
148
        },
149
        "tracking": {
150
          "duration_us": "8",
151
          "transitions": "1"
152
        }
153
      },
154
      "time": "2026-Mar-03 03:04:47.516196 UTC",
155
      "uptime": 1852743,
156
      "validated_ledger": {
157
        "base_fee": 10,
158
        "close_time": 825822281,
159
        "hash": "239AEF90407AA56065E9BCA6D52D21C187FB98B47B541ACC942D636801B71E0D",
160
        "reserve_base": 1000000,
161
        "reserve_inc": 200000,
162
        "seq": 102609807
163
      },
164
      "validation_quorum": 28,
165
      "validator_list_expires": 832615656
166
    },
167
    "status": "success"
168
  },
169
  "status": "success",
170
  "type": "response",
171
  "forwarded": true,
172
  "warnings": [
173
    {
174
      "id": 2001,
175
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
176
    }
177
  ]
178
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free