> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/monad-mon/eth_getblockbynumber-monad.md).

# eth\_getBlockByNumber - Monad

Example code for the eth\_getBlockByNumber JSON-RPC method. Complete guide on how to use eth\_getBlockByNumber JSON-RPC in GetBlock Web3 documentation.

This method returns information about a block by block number.

## Parameters

| Parameter        | Type    | Required | Description                                                                           |
| ---------------- | ------- | -------- | ------------------------------------------------------------------------------------- |
| blockNumber      | string  | Yes      | Block number in hex, or "latest", "earliest", "pending", "safe", "finalized".         |
| fullTransactions | boolean | Yes      | If true, returns full transaction objects; if false, returns only transaction hashes. |

## Request

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": "getblock.io"
}'
```

{% endtab %}

{% tab title="Axios" %}

```javascript
import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));
```

{% endtab %}

{% tab title="Request" %}

```python
import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endtab %}

{% tab title="Rust" %}

```rust
use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "eth_getBlockByNumber",
            "params": ["latest", false],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}
```

{% endtab %}
{% endtabs %}

## Response

```json
{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "number": "0x1b4",
        "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
        "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
        "nonce": "0x0000000000000000",
        "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
        "logsBloom": "0x00000000000000000000000000000000...",
        "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "stateRoot": "0xd5855eb08b3387c0af375e9cdb6acfc05eb8f519e419b874b6ff2ffda7ed1dff",
        "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
        "miner": "0x0000000000000000000000000000000000000000",
        "difficulty": "0x0",
        "totalDifficulty": "0x0",
        "extraData": "0x",
        "size": "0x220",
        "gasLimit": "0x1c9c380",
        "gasUsed": "0x0",
        "timestamp": "0x65a1c2b4",
        "transactions": [],
        "uncles": [],
        "baseFeePerGas": "0x7"
    }
}
```

## Response Parameters

| Field            | Type   | Description                                          |
| ---------------- | ------ | ---------------------------------------------------- |
| number           | string | Block number in hex.                                 |
| hash             | string | 32-byte hash of the block.                           |
| parentHash       | string | 32-byte hash of the parent block.                    |
| nonce            | string | 8-byte proof-of-work nonce (always 0 for Monad PoS). |
| sha3Uncles       | string | SHA3 of uncles data.                                 |
| logsBloom        | string | 256-byte bloom filter for logs.                      |
| transactionsRoot | string | Root of the transaction trie.                        |
| stateRoot        | string | Root of the state trie.                              |
| receiptsRoot     | string | Root of the receipts trie.                           |
| miner            | string | Address of the block producer.                       |
| difficulty       | string | Difficulty (0 for PoS).                              |
| totalDifficulty  | string | Total difficulty of the chain.                       |
| extraData        | string | Extra data field.                                    |
| size             | string | Size of the block in bytes.                          |
| gasLimit         | string | Maximum gas allowed in the block.                    |
| gasUsed          | string | Total gas used by transactions.                      |
| timestamp        | string | Unix timestamp of the block.                         |
| transactions     | array  | Array of transaction hashes or objects.              |
| baseFeePerGas    | string | Base fee per gas (EIP-1559).                         |

## Use Case

The `eth_getBlockByNumber` method is essential for:

* Building block explorers
* Analyzing blockchain data
* Tracking block production on Monad's fast chain
* Transaction confirmation verification
* Historical data analysis
* Real-time block monitoring

## Error Handling

| Status Code | Error Message      | Cause                            |
| ----------- | ------------------ | -------------------------------- |
| 403         | Forbidden          | Missing or invalid ACCESS-TOKEN. |
| -32602      | Invalid params     | Invalid block number format.     |
| -32000      | Resource not found | Block not found.                 |

## Web3 Integration

{% tabs %}
{% tab title="Ethers.js" %}

```javascript
import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/');
const block = await provider.getBlock('latest');
console.log('Block:', block.number, 'Hash:', block.hash);
```

{% endtab %}

{% tab title="Viem" %}

```javascript
import { createPublicClient, http } from "viem";
import { monad } from "viem/chains";

// Create Viem client with GetBlock
const client = createPublicClient({
  chain: monad,
  transport: http(
    import.meta.env.MONAD_ACCESS_TOKEN
  ),
});

// Using the method through Viem
async function Call() {
  try {
    // Method-specific Viem implementation
    const result = await client.request({
     method: "eth_getBlockByNumber",
     params: ["latest", false],
    });
    console.log("Result:", result);
    return result;
  } catch (error) {
    console.error("Viem Error:", error);
    throw error;
  }
}
```

{% endtab %}
{% endtabs %}