eth_syncing

Returns an object with data about the sync status or false.

Parameters

None.

Returns

• sync status: (boolean) Returns false only when not syncing.
• sync blocks:
  • startingBlock: A hexadecimal equivalent the integer indicating the block at which the import started (will only be reset after the sync reaches the head).
  • currentBlock: A hexadecimal equivalent the integer indicating the current block, same as eth_blockNumber.
  • highestBlock: A hexadecimal equivalent the integer indicating the highest block.

Example

Replace <YOUR-API-KEY> with an API key from your Infura dashboard.

Request

cURL

curl https://mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_syncing", "params": [], "id": 1}'

WSS

wscat -c wss://mainnet.infura.io/ws/v3/<YOUR-API-KEY> -x '{"jsonrpc": "2.0", "method": "eth_syncing", "params": [], "id": 1}'

Response

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}