RPC method

eth_getBlockByNumber on Story

Supported on SwiftNodes

Everything below was measured on 2026-10-13 by calling eth_getBlockByNumber on Story through the same endpoint customers use, and is re-measured weekly.

What eth_getBlockByNumber does

Returns a block by number or tag (latest, safe, finalized, pending, earliest): the header, and either the transaction hashes or the full transactions. Indexers, explorers and wallets use it to follow the chain.

eth_getBlockByNumber on Story: what we measured

Header fields	26
Transactions per block	0, 0, 0, 0, 0 in five consecutive blocks
Response size, full transactions (true)	1.8 KB average
Response size, hashes only (false)	1.9 KB
Gas limit	36,000,000
Gas used in the latest block	0 (0.000% of the limit)
Base fee	23 wei
Tag "safe"	block 23,300,083
Tag "finalized"	block 23,300,084
Tag "pending"	block 23,300,086
Tag "earliest"	block 0

What is different on Story

The header includes the fields added by London (EIP-1559 base fee), Shanghai (withdrawals), Cancun (EIP-4844 blob gas), Cancun (EIP-4788 beacon root), Prague (EIP-7685 requests). Code that assumes Ethereum's current header shape will parse it as is.

A real Story block header

From block 23,300,079, as our endpoint returned it (long hex values shortened).

{
  "baseFeePerGas": "0x17",
  "blobGasUsed": "0x0",
  "difficulty": "0x0",
  "excessBlobGas": "0x0",
  "extraData": "0xd883010203846765746888676f312e32342e30856c696e7578",
  "gasLimit": "0x2255100",
  "gasUsed": "0x0",
  "hash": "0x01d086054f9f65cd8f1e91a9915e9f768bf88967ff6db7bd12245357bc094ef4",
  "logsBloom": "0x0000000000000000…(256 bytes)",
  "miner": "0x0cec190e690f9fecfd076ef639e20f96969a4667",
  "mixHash": "0xf5196be0f6a3a0d35e25806a067b7dd97542ae5a544b888a21b079e2a4cd4e69",
  "nonce": "0x0000000000000000",
  "number": "0x16387ef",
  "parentBeaconBlockRoot": "0x3ac392a96a8acb24c34d5320640865a45280b8a4ade59ab48a76ffff5312015a",
  "parentHash": "0xf5196be0f6a3a0d35e25806a067b7dd97542ae5a544b888a21b079e2a4cd4e69",
  "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
  "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  "size": "0x2a2",
  "stateRoot": "0xcc078f84d58b02e5e69b21e13236a975e5e5e5b47cd9a5b4c1a438866a89e5ac",
  "timestamp": "0x6ace2dfe",
  "transactions": "0 transactions",
  "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
  "uncles": [],
  "withdrawals": [
    {
      "address": "0xdd8dcf28fea93d103e7f1b925325ba32686c64d2",
      "amount": "0x1eba53910",
      "index": "0x3e4046",
      "validatorIndex": "0x1"
    }
  ],
  "withdrawalsRoot": "0x8881b22793cdff2ffd4464c1d51789c81193d1c42f2e2087507004ff9d601e03"
}

Example request

curl -s https://rpc.swiftnodes.io/rpc/story?key=YOUR_API_KEY \
  -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByNumber","params":["latest",false]}'

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://rpc.swiftnodes.io/rpc/story?key=YOUR_API_KEY"),
});

// Header plus transaction hashes (1.9 KB)
const block = await client.getBlock({ blockTag: "latest" });

// With full transactions (1.8 KB on average on Story)
const full = await client.getBlock({ blockNumber: block.number, includeTransactions: true });

// A block that will not be reorganised
const final = await client.getBlock({ blockTag: "finalized" });

Other methods on Story

eth_blockNumberSupported
eth_chainIdSupported
eth_getBalanceSupported
eth_getTransactionByHashNot measured
eth_getTransactionReceiptNot measured
eth_callSupported
eth_estimateGasSupported
eth_gasPriceSupported
eth_maxPriorityFeePerGasSupported
eth_sendRawTransactionSupported
eth_getTransactionCountNot measured
eth_getCodeSupported
eth_subscribeSupported
eth_getLogsSupported
eth_getBlockReceiptsSupported
eth_feeHistorySupported
eth_getProofSupported
eth_createAccessListSupported
debug_traceCallNot available
trace_blockNot available
trace_transactionNot available

eth_getBlockByNumber on other chains

Frequently asked questions

Does Story support eth_getBlockByNumber?

Yes. eth_getBlockByNumber answered on the SwiftNodes Story endpoint when our weekly probe called it through the customer path (2026-10-13).

How many transactions are in each Story block?

In five consecutive blocks on 2026-10-13: 0, 0, 0, 0, 0.

Story endpoints, live block height and WebSocket status are on the Story RPC page.

One key covers every chain we serve, and SwiftNodes has a free tier.