Get block information by block hash

POST

https://bsc.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns information about a block specified by its hash.
The second parameter determines whether full transaction objects or only transaction hashes are returned.

Body

application/json

Returns information about a block specified by its hash.
The second parameter determines whether full transaction objects or only transaction hashes are returned.

Request payload for Get block information by block hash.

jsonrpcstringrequired

JSON-RPC protocol version (always "2.0")

methodstringrequired

The JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block hash (string)
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request identifier

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

JSON-RPC method or upstream error

Get block information by block hash

curl -X POST 'https://bsc.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
      false
    ],
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://bsc.nownodes.io/");
const result = await provider.send("eth_getBlockByHash", [
  "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
  false
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://bsc.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://bsc.nownodes.io/"))
response = w3.provider.make_request("eth_getBlockByHash", [
  "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
  false
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://bsc.nownodes.io/"),
});

const result = await client.request({
  method: "eth_getBlockByHash",
  params: [
  "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
  false
],
});

console.log(result);

const endpoint = "https://bsc.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "eth_getBlockByHash", params: [
  "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
  false
], id: 1 });
console.log(result);

const response = await fetch('https://bsc.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockByHash",
      "params": [
        "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
        false
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

response = requests.post('https://bsc.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://bsc.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
      false
    ],
    "id": 1
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

Documentation

How to migrate to NOWNodes

Get block information by block hash

Authorizations

Body

Response