Skip to main content

eth_syncing

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

For Growth and Custom service plans

This JSON-RPC method allows a request to be forwarded to a partner service provider if Infura should experience a service issue or outage. See Failover protection and Enable API request forwarding for complete details.

If you would like failover protection but don't qualify under your current plan, then either self-upgrade to the Growth plan or contact a sales representative to upgrade to a Custom plan.

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 MetaMask Developer dashboard.

Request​

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

Response​

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