ledger RPC Method

Parameters

object

object

REQUIRED

Loading...

ledger_index

string

Loading...

transactions

boolean

Loading...

expand

boolean

Loading...

owner_funds

boolean

Loading...

Returns

result

object

Loading...

ledger

object

Loading...

accepted

boolean

Loading...

account_hash

string

Loading...

close_flags

integer

Loading...

close_time

integer

Loading...

close_time_human

string

Loading...

close_time_resolution

integer

Loading...

closed

boolean

Loading...

hash

string

Loading...

ledger_hash

string

Loading...

ledger_index

string

Loading...

parent_close_time

integer

Loading...

parent_hash

string

Loading...

seqNum

string

Loading...

totalCoins

string

Loading...

total_coins

string

Loading...

transaction_hash

string

Loading...

ledger_hash

string

Loading...

ledger_index

integer

Loading...

status

string

Loading...

validated

boolean

Loading...

type

string

Loading...

diff

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": "ledger",
6
  "params": [
7
    {
8
      "ledger_index": "current",
9
      "transactions": false,
10
      "expand": false,
11
      "owner_funds": false
12
    }
13
  ],
14
  "id": 1
15
}'

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": "ledger",
6
  "params": [
7
    {
8
      "ledger_index": "current",
9
      "transactions": false,
10
      "expand": false,
11
      "owner_funds": false
12
    }
13
  ],
14
  "id": 1
15
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'ledger',
4
    params: [{"ledger_index":"current","transactions":false,"expand":false,"owner_funds":false}],
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: 'ledger',
4
    params: [{"ledger_index":"current","transactions":false,"expand":false,"owner_funds":false}],
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": "ledger",
9
  "params": [
10
    {
11
      "ledger_index": "current",
12
      "transactions": False,
13
      "expand": False,
14
      "owner_funds": False
15
    }
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
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": "ledger",
9
  "params": [
10
    {
11
      "ledger_index": "current",
12
      "transactions": False,
13
      "expand": False,
14
      "owner_funds": False
15
    }
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
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: "ledger",
11
  params: [{"ledger_index":"current","transactions":false,"expand":false,"owner_funds":false}]
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: "ledger",
11
  params: [{"ledger_index":"current","transactions":false,"expand":false,"owner_funds":false}]
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
    "ledger": {
4
      "closed": false,
5
      "ledger_index": "102609805",
6
      "parent_hash": "7735091DF9F32511F41AD963A8BDE4AF24B27D3AA3946903A31E3CFF2B948217"
7
    },
8
    "ledger_current_index": 102609805,
9
    "validated": false,
10
    "status": "success"
11
  },
12
  "status": "success",
13
  "type": "response",
14
  "forwarded": true,
15
  "warnings": [
16
    {
17
      "id": 2001,
18
      "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"
19
    }
20
  ]
21
}

1
{
2
  "result": {
3
    "ledger": {
4
      "closed": false,
5
      "ledger_index": "102609805",
6
      "parent_hash": "7735091DF9F32511F41AD963A8BDE4AF24B27D3AA3946903A31E3CFF2B948217"
7
    },
8
    "ledger_current_index": 102609805,
9
    "validated": false,
10
    "status": "success"
11
  },
12
  "status": "success",
13
  "type": "response",
14
  "forwarded": true,
15
  "warnings": [
16
    {
17
      "id": 2001,
18
      "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"
19
    }
20
  ]
21
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free