Parameters

This method does not accept any parameters

Returns

result

object

The blockchain information object

chain

string

The name of the current network (main, test, regtest)

blocks

integer

The height of the most-work fully-validated chain. The genesis block has height 0

headers

integer

The current number of headers validated

bestblockhash

string

The hash of the current best block

bits

string

A compact encoding of the block's difficulty target in hexadecimal format

target

string

The current proof-of-work target

difficulty

number

The difficulty of the highest height block

time

integer

The time for the current best block

mediantime

integer

The median time for the current best block

verificationprogress

number

An estimate of verification progress [0..1]

initialblockdownload

boolean

(debug information) An estimate of whether this node is in Initial Block Download mode

chainwork

string

Total amount of work in active chain in the hexadecimal form

size_on_disk

integer

The estimated size of the block and undo files on disk

pruned

boolean

It indicates if the blocks are subject to pruning

warnings

string

An array of strings of network and blockchain warnings

error

object | null

(Optional) JSON-RPC error when the request failed; omitted or null on success

code

integer

Error code

message

string

Error message

Request

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

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

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

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.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: 'getblockchaininfo',
4
    params: [],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.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.btc.quiknode.pro/"
5

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

16
response = requests.request("POST", url, headers=headers, data=payload)
17

18
print(response.text)

1
import requests
2
import json
3

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

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

16
response = requests.request("POST", url, headers=headers, data=payload)
17

18
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockchaininfo",
11
  params: []
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.btc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockchaininfo",
11
  params: []
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
  "jsonrpc": "2.0",
3
  "result": {
4
    "chain": "main",
5
    "blocks": 933586,
6
    "headers": 933586,
7
    "bestblockhash": "00000000000000000000b286a4d4ac73f6ad82e54d9ccf6d2d71c492ceeb4930",
8
    "bits": "1701fca1",
9
    "target": "00000000000000000001fca10000000000000000000000000000000000000000",
10
    "difficulty": 141668107417558.2,
11
    "time": 1769215475,
12
    "mediantime": 1769212489,
13
    "verificationprogress": 0.9999987925138323,
14
    "initialblockdownload": false,
15
    "chainwork": "0000000000000000000000000000000000000001099579552ee2c6500b5ec71f",
16
    "size_on_disk": 814911000113,
17
    "pruned": false,
18
    "warnings": ""
19
  },
20
  "id": 1
21
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "chain": "main",
5
    "blocks": 933586,
6
    "headers": 933586,
7
    "bestblockhash": "00000000000000000000b286a4d4ac73f6ad82e54d9ccf6d2d71c492ceeb4930",
8
    "bits": "1701fca1",
9
    "target": "00000000000000000001fca10000000000000000000000000000000000000000",
10
    "difficulty": 141668107417558.2,
11
    "time": 1769215475,
12
    "mediantime": 1769212489,
13
    "verificationprogress": 0.9999987925138323,
14
    "initialblockdownload": false,
15
    "chainwork": "0000000000000000000000000000000000000001099579552ee2c6500b5ec71f",
16
    "size_on_disk": 814911000113,
17
    "pruned": false,
18
    "warnings": ""
19
  },
20
  "id": 1
21
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free