server_state RPC Method

Parameters

object

object

REQUIRED

Loading...

Returns

result

object

Loading...

state

object

Loading...

build_version

string

Loading...

complete_ledgers

string

Loading...

initial_sync_duration_us

string

Loading...

io_latency_ms

integer

Loading...

jq_trans_overflow

string

Loading...

last_close

object

Loading...

converge_time_s

integer

Loading...

proposers

integer

Loading...

load

object

Loading...

job_types

array

Loading...

in_progress

integer

Loading...

job_type

string

Loading...

threads

integer

Loading...

load_base

integer

Loading...

load_factor

integer

Loading...

load_factor_fee_escalation

integer

Loading...

load_factor_fee_queue

integer

Loading...

load_factor_fee_reference

integer

Loading...

load_factor_server

integer

Loading...

network_id

integer

Loading...

peer_disconnects

string

Loading...

peer_disconnects_resources

string

Loading...

peers

integer

Loading...

pubkey_node

string

Loading...

server_state

string

Loading...

server_state_duration_us

string

Loading...

state_accounting

object

Loading...

connected

object

Loading...

duration_us

string

Loading...

transitions

string

Loading...

disconnected

object

Loading...

duration_us

string

Loading...

transitions

string

Loading...

full

object

Loading...

duration_us

string

Loading...

transitions

string

Loading...

syncing

object

Loading...

duration_us

string

Loading...

transitions

string

Loading...

tracking

object

Loading...

duration_us

string

Loading...

transitions

string

Loading...

time

string

Loading...

uptime

integer

Loading...

validated_ledger

object

Loading...

age

integer

Loading...

hash

string

Loading...

seq

integer

Loading...

base_fee_xrp

integer

Loading...

reserve_base_xrp

integer

Loading...

reserve_inc_xrp

integer

Loading...

validation_quorum

integer

Loading...

validator_list_expires

integer

Loading...

status

string

Loading...

type

string

Loading...

forwarded

boolean

Loading...

warnings

array

Loading...

id

integer

Loading...

message

string

Loading...

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