Returns information about a block by number or tag.

POST

wss://bsc.nownodes.io/wss/{apiKey}

Returns block information for a block number (hex) or tag (latest, earliest, pending, finalized, safe). The second parameter controls whether full transaction objects (true) or only hashes (false) are returned.

Body

application/json

JSON-RPC 2.0 request for eth_getBlockByNumber, sent as a text message over the WebSocket connection.

jsonrpcstringrequired

idintegerrequired

Request identifier echoed back in the response.

methodstringrequired

paramsArray<any>required

Parameters

apiKeystringrequiredpath

NOWNodes API key. Connect to wss://bsc.nownodes.io/wss/{apiKey}. The WebSocket handshake returns HTTP 403 when the key is missing or invalid.

Response

200OK

JSON-RPC response delivered over the WebSocket connection. Errors are reported inside the same envelope in the error field; see RpcError (live: code -32602 Invalid params for malformed arguments).

403Forbidden

Forbidden. The WebSocket handshake was rejected: the API key is missing or invalid (verified live: wrong and missing keys both return HTTP 403).

Returns information about a block by number or tag.

curl -X POST 'wss://bsc.nownodes.io/wss/{apiKey}' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getBlockByNumber",
    "params": [
      "latest",
      false
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("wss://bsc.nownodes.io/wss/{apiKey}");
const result = await provider.send("eth_getBlockByNumber", [
  "latest",
  false
]);
console.log(result);

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

uri = URI('wss://bsc.nownodes.io/wss/{apiKey}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    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("wss://bsc.nownodes.io/wss/{apiKey}"))
response = w3.provider.make_request("eth_getBlockByNumber", [
  "latest",
  false
])
print(response)

import { createPublicClient, http } from "viem";

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

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

console.log(result);

const endpoint = "wss://bsc.nownodes.io/wss/{apiKey}";
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_getBlockByNumber", params: [
  "latest",
  false
], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ]
}

response = requests.post('wss://bsc.nownodes.io/wss/{apiKey}', json=payload)
data = response.json()

require 'net/http'
require 'json'

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

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",
  "id": 1,
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ]
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "hash": "0x2b813172b907e8fe1d124239688cc05928c9796125abbe8ec21900d0e89bdedf",
    "parentHash": "0xacaefe037229da5dee45d22f34bd802914acd45c2594d259c18cb9c9a4837f7f",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0x58567f7a51a58708c8b40ec592a38ba64c0697de",
    "stateRoot": "0x587bdb43b29f0dbdc6d56080cafd94b46e5bf065099153c628e7c6af573531af",
    "transactionsRoot": "0x5dc01c7ec015e9c92b339e8b77fef906ae39574c0a850fab160e585d57b88b62",
    "receiptsRoot": "0x1546d2ca0a8b87ec589deeff6b6ec868aa30dfb05864687e082ab8c1f18b1259",
    "logsBloom": "0xf86eaadc57d844430a77806e9599f6849c9e49228a085a790187102b6f5410855f08300205075403cb2ac881207a0b42ceee6e42b620352ca3be13b1c1262a93c6b11614e6cea279a5bb51b9b23e68e66edc7ca089e54a48586c1382c02c1eb05018b7383aba7860b76530376db59fd08922c06f4834c51ea0165ad4e05a8689b0700618bf981fd00f98a58a410171b9d36764355a604148770a0d4815dadea00e2ca201d814e8b63e3dab956ac18591101652d0168808cb01d78426de81fa2279d601aaf4894cfeb01d1e823e71b511bec4ca9a9d4c11d971d6e81e2c15be1478d8600582c7798255c5424d81d33354a065e411c5a210c9e33bfd20aa514633",
    "difficulty": "0x2",
    "number": "0x7127410",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0xb3c53a",
    "timestamp": "0x6a92017c",
    "extraData": "0xdb8301070888636462373534386289676f312e32352e3132836c696ed38cc282f8b5830f7fffb860b1c5d46f7e9cb1d6620e9263291b6f4c18195c1614732fe0bba36e40e00589d5c983259bf0ddbdea3481b4b4240ed38418cba2e37720c0d81ea13e016827b0f7813cbbf82883905907388457f43b447d493e9315ebd737ec6ada9459b6842c11f84c840712740ea0ea9c6557a151c7495197e02e7ecbb53ada44da9fa19a7f2b40feb64442960681840712740fa0acaefe037229da5dee45d22f34bd802914acd45c2594d259c18cb9c9a4837f7f80b96c77f90947734c01c6c2b5a516d0cc2468ad6e688a99a319c5dddca9f00c187c83b1dc3c69de0e7f08c06d711461641cedffb9c2eebf45c5e9fff8a0e7c04301",
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000384",
    "nonce": "0x0000000000000000",
    "baseFeePerGas": "0x0",
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "blobGasUsed": "0x0",
    "excessBlobGas": "0x0",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "requestsHash": "0x0000000000000000000000024827b423d03a349b7519dda537e9a28d31ecbb48",
    "totalDifficulty": "0xe1bf99e",
    "size": "0xca2f",
    "milliTimestamp": "0x1a04a55cfe4",
    "uncles": [],
    "transactions": [
      "0x030be9818484b2ff657fa5f26f6e839dd5569bb49219f8fd403feda768752e6b",
      "0x4a093a97cd883e9133fdfc9719f29548fc09df59e88e90c5775155185d94e566",
      "0xa7d19ebe7040bf3fa8997eee0e7e78a256caf6467ee11f706837086e363017eb",
      "0xbffba95ad37f00ab63b85860a9a0891c815364f6f49be6f1760386db1baa0c0f",
      "0x9ee0942079a5a2c20770ced356d2b016a91f687ce81ff1bba6390d7fac301927",
      "0xfbc9dceda5ed5e7c2055660d3f3fd988e11e726a9d39cd76d3e63276a70e55ad",
      "0x649b2e10a04c1f17e78f3cb49c5ba4dd7f3ac5fbac3b5eb699d59782c5a77b5b",
      "0x02194e29fa3428339be1fd7dcb578cdb242d35e4087c7f1514a527bb40749456",
      "0x1bf21f6471f64b74a6411c186e369ba13a40930acaaca086a15013cd82c9ce26",
      "0xfdf68b592018bbf0bea2c66059e6dfe0ce78b5c41b0052a00004b6f37dbcbb38",
      "0xc68cceb950260adf24b4c8a28fc1d5fef95e5dc248fb653340c0e8925c688f34",
      "0xf5467af93b61d2c8baa67795cb85491bea3f56b04efc5a9f8b6a7c9e2c687527",
      "0x25c16c8a969867938f83994db98c328dab32d84bff0203a6595d0e27f3e79074",
      "0x029a7090efd17de99754220cd0423697cd7d033da6ab22be1d1b7c845de62eab",
      "0xd5e974405fab5ddfb8330a734d1e082f0d15eee1da70298859ad0137db9b6d07",
      "0xe684476e2ada62c04e5072217369ddd4c0eec92305c633d12272cd3106dc9f18",
      "0xe081c6642bb6644074e4d476032c0e758909aa5c07e9264465200d950bb65fae",
      "0x0f86f13f212cef05deed39535bcf46ec60bd87c839e732e364d4c2d833f006ea",
      "0xf4e6ccf283e5cbdb3948ccb1d0b0b1051e725c18620a600365eadfb22671da4c",
      "0x51d058e961dd2a3c6baa8d4634e7b5a9e6aabde1024fcf637345c460907a99a3",
      "0xc8fb81f115400c14b44430bf29de162f636683545f40a794c17e40055237fe91",
      "0x9655ac581a7b152ea2b411f7e994db05881a01e790a5f98105b3d8bef456eefd",
      "0x6abb7cec12967ee96923a15b6f914985059717d4f0e37d883c34825c558d8bb5",
      "0xccfbb67b3505b6d11a507591718aafccd4cde220e0d82937013027656d7160b9",
      "0x0eff7f8caede720ff97a41a3143ecddd39e0ff83a76e7b9a9dbc0696bde6207b",
      "0x454e3d94b6ff22b66ee304488ae4fa53c86a9054c24f0db7debc921a5047bbba",
      "0x5eabeaa780ecb701e6d8c41ecec231ff137689a4d283963b104a123e712874ea",
      "0x52a56b79bf54d57d217c50172001cfa9e5603983c79570bd7d41a847a81bd456",
      "0x46a4ad0b00862051462bf4898e7246adc5b07e39f9827e6d4daf8adef2c99fe5",
      "0xd431d1248edf54e3a6a0296bb1a8612d6df8a260a7f6ce7ed5e2af12f31be1cf",
      "0x3646500814c82191ce2ebe0d8853061ec74b7a50bedaccf0a5f47af1c42d75d3",
      "0x2d5c4b44c14499576cdc33f09455d715f235f31d643626b99041ba160ea89b95",
      "0xba7bd0e9317a1f3ffb564de134ae4cb6e3f9b9146150849ebcb21fff226b202c",
      "0x6c8d2bde92bf958c0e408663f4baf6a0929b02fbc85c632f72f66306441fb849",
      "0x1bc9ca222f10b87835cf8b2433970af92c4f81d99c25974318a191c02c742143",
      "0xbc0e27adcf76125c7e5d33589600b5b78f63f650afeb1cee62489d89815f964f",
      "0x44a2f9bf05c69bb27958c243a7c031215f08d50369b20a4552d62f21fdbded2a",
      "0xc0d5557b8a9e1a662a012c2508846e143ad426479c648fdedbeb0c86dd7df069",
      "0x1b4a40e8735680f7a5b3bc68660b07eab0f48734b5ebf780b81772df00a1b192",
      "0x88fd843f82ade8d33e7a672f03b9f7eaac7851f30e48293517a54daa9cc6fc79",
      "0xa222fc9a55e0c6ae977a48ba9d4779dcdc2b914cf739b8953217d4729df9f6b8",
      "0xd5f98929f2c8e495a71c9d5be4d5a9170c4adf9d3a0b72ac829d011f30c1e2e0",
      "0x7428a782b02adfa343c0d0ae5185cafa5032890df84508a5d61da2c69cde2258",
      "0x36605e7048949aba0bcad05e28267268c37fe522313dfce6402571b067bafd4f",
      "0x7813672253ef3c2c776c0951211721eec764b276ba0117ee41556f231677e074",
      "0x9d6dfb3d7f0726d9c87a01750b99ad52c1467ff42b9575b2f19acb1099e4dffb",
      "0xf0f97f706cc1e7ca1de63bfbcd244b42f8961d44471b8c10d6485fa72ced1147",
      "0xf7b2a5da53fd5bd2fe40fbaaae150e0ba5025141f89ed0fdbf081f709c2b7b9a",
      "0x12d4a511f1c7f02642b5d0c8c4d0ceec09fff34de4ef13e4d19ba2cc6a716015",
      "0x7ba9b04688f52843f5142ea8b458d8da2bca3ae158debcafd849b5ee5d0d31b0",
      "0x922b74dbd50618e905798fb67362ff76c1636a326ea2175d8bfc3c9481282778",
      "0xac397fe6913709b266489537d360a0ac863a1045308eefc6305289a50e893a52",
      "0xcea115868580c4089518dc2bfd548d3db6dfe3b61bb5679a31a69b8def120830",
      "0x1dffe06958e6450c2a9874279c078f78a504ed2211b160ed9eb491208b863f76",
      "0xc4c04b2fdb747a7edc7e1641d8448943646d9393ee30637a9cf9b323ae6e0ca5",
      "0x9668386857bf77bcd6e2f23c515a5a1f7462a6fa674e47445cac79b7a4356598",
      "0x4dcd0b2708892af5d0b94e92c3cffe35daebbe4d42192d19779c84779ad6b005",
      "0x06ab94425344f12ca72baf39b094d2f460430b136f21bb7342855df9df0c0699"
    ],
    "withdrawals": []
  }
}

string

Documentation

How to migrate to NOWNodes

Returns information about a block by number or tag.

Body

Parameters

Response