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
}