Parameters

object

object

REQUIRED

The server_info request object.

ledger_index

string

ledger_index

Returns

result

object

The details of the result

info

object

The info object which contains the following fields:

build_version

string

The version number of the running server

complete_ledgers

string

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

hostid

string

It returns the hostname of the server on admin request

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

number

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_factor

integer

It is the load-scaled open ledger transaction cost the server is currently enforcing

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

number | 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

number | 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

status

string

The status of the request

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_info",
6
  "params": [
7
    {
8
      "ledger_index": "current"
9
    }
10
  ],
11
  "id": 1
12
}'

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_info",
6
  "params": [
7
    {
8
      "ledger_index": "current"
9
    }
10
  ],
11
  "id": 1
12
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'server_info',
4
    params: [{"ledger_index":"current"}],
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_info',
4
    params: [{"ledger_index":"current"}],
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(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"server_info\",\"params\":[{\"ledger_index\":\"current\"}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"server_info\",\"params\":[{\"ledger_index\":\"current\"}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
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_info",
11
  params: [{"ledger_index":"current"}]
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_info",
11
  params: [{"ledger_index":"current"}]
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
    "info": {
4
      "complete_ledgers": "32570-102609807",
5
      "load_factor": 1,
6
      "time": "2026-Mar-03 03:04:46.673396 UTC",
7
      "uptime": 1852778,
8
      "clio_version": "2.7.0",
9
      "libxrpl_version": "3.0.0",
10
      "validated_ledger": {
11
        "age": 5,
12
        "hash": "239AEF90407AA56065E9BCA6D52D21C187FB98B47B541ACC942D636801B71E0D",
13
        "seq": 102609807,
14
        "base_fee_xrp": 0.00001,
15
        "reserve_base_xrp": 1,
16
        "reserve_inc_xrp": 0.2
17
      },
18
      "cache": {
19
        "size": 18875142,
20
        "is_enabled": true,
21
        "is_full": true,
22
        "latest_ledger_seq": 102609807,
23
        "object_hit_rate": 0.9729745388031006,
24
        "successor_hit_rate": 0.9890366196632385
25
      },
26
      "validation_quorum": 28,
27
      "rippled_version": "3.1.0",
28
      "network_id": 0
29
    },
30
    "validated": true,
31
    "status": "success"
32
  },
33
  "warnings": [
34
    {
35
      "id": 2001,
36
      "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"
37
    }
38
  ]
39
}

1
{
2
  "result": {
3
    "info": {
4
      "complete_ledgers": "32570-102609807",
5
      "load_factor": 1,
6
      "time": "2026-Mar-03 03:04:46.673396 UTC",
7
      "uptime": 1852778,
8
      "clio_version": "2.7.0",
9
      "libxrpl_version": "3.0.0",
10
      "validated_ledger": {
11
        "age": 5,
12
        "hash": "239AEF90407AA56065E9BCA6D52D21C187FB98B47B541ACC942D636801B71E0D",
13
        "seq": 102609807,
14
        "base_fee_xrp": 0.00001,
15
        "reserve_base_xrp": 1,
16
        "reserve_inc_xrp": 0.2
17
      },
18
      "cache": {
19
        "size": 18875142,
20
        "is_enabled": true,
21
        "is_full": true,
22
        "latest_ledger_seq": 102609807,
23
        "object_hit_rate": 0.9729745388031006,
24
        "successor_hit_rate": 0.9890366196632385
25
      },
26
      "validation_quorum": 28,
27
      "rippled_version": "3.1.0",
28
      "network_id": 0
29
    },
30
    "validated": true,
31
    "status": "success"
32
  },
33
  "warnings": [
34
    {
35
      "id": 2001,
36
      "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"
37
    }
38
  ]
39
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free