eth_syncing - Monad

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

This method returns an object with data about the sync status or false if not syncing.

Parameters

• None

Request

cURL

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_syncing",
    "params": [],
    "id": "getblock.io"
}'

Axios

Python

Rust

Response

Not Syncing

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": false
}

Syncing

Response Parameters

Field	Type	Description
result	boolean/object	False if not syncing, or sync status object.
startingBlock	string	Block number where sync started (hex).
currentBlock	string	Current block being synced (hex).
highestBlock	string	Highest known block (hex).

Use Case

The eth_syncing method is essential for:

• Node health monitoring

• Sync progress tracking

• Application readiness checks

• Infrastructure monitoring

• Load balancer health checks

• User notifications about node status

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN.

Web3 Integration

Ethers.js

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const syncStatus = await provider.send('eth_syncing', []);

if (syncStatus === false) {
    console.log('Node is fully synced');
} else {
    const current = parseInt(syncStatus.currentBlock, 16);
    const highest = parseInt(syncStatus.highestBlock, 16);
    const progress = ((current / highest) * 100).toFixed(2);
    console.log(`Syncing: ${progress}% (${current}/${highest})`);
}