Get Block by Number

POST

https://plasma.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string | boolean>required

Array with 2 parameters:

Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
Boolean to specify if full transaction objects are returned (true) or only transaction hashes (false)

Show child attributes

One of

Block number as hex string or special tag

string

Return full transaction objects if true; else return only transaction hashes

boolean

idintegerrequired

Request ID

Response

200OK

Block information

Get Block by Number

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://plasma.nownodes.io/");
const result = await provider.send("eth_getBlockByNumber", [
  "0x1b4"
]);
console.log(result);

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

const endpoint = "https://plasma.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_getBlockByNumber", params: [
  "0x1b4"
], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

uri = URI('https://plasma.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": [
      "0x1b4"
    ],
    "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_getBlockByNumber",
  "params": [
    "0x1b4"
  ],
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79",
    "parentHash": "0x5e8d5f58b0c1be8c3a3d172a41f9f4e35f2f15d5b3347f17a6c11a3aeadf9c10",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9e7a6ccfbcc2fdb5d98a9fdb716e0df485b4d39a5a6f85ebd",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x829BD824B016326A401d083B33D092293333A830",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": [
      "0x9f1c04b814a153e1b9f11b60d4e0f9349d07f9251e9b7b60aebb21721c8c07d7"
    ],
    "uncles": [
      "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    ]
  }
}

Documentation

How to migrate to NOWNodes

Get Block by Number

Authorizations

Body

Response