Skip to Content
WebSocket API

syncing

Receive sync-status updates over the hosted EVM route.

Topicsyncing
Route familyEVM
StageAvailable

Available under EVM WebSocket API. Use the chain-family pages for handle discovery and this page for exact subscription semantics.

Access

  • Surfaces: raw_rpc_ws
  • Metering: raw_rpc_ws_target_minute
  • Scope: EVM sync-status subscription

Handles

SurfaceLabelValue
raw_rpc_wsEndpoint{RPC_WSS_BASE_URL}/v1/ethereum/{API_KEY}
raw_rpc_wsSubscribe methodeth_subscribe
raw_rpc_wsNotification methodeth_subscription

Use `syncing` when the runtime needs to detect whether the selected EVM route is still catching up or is fully synced.

Examples use `/v1/ethereum/{api_key}`. The same reviewed topic set applies across the current public EVM websocket routes in the gateway baseline.

Examples

Connect with compatibility URL
wscat -c "{RPC_WSS_BASE_URL}/v1/ethereum/{api_key}"> {> "jsonrpc": "2.0",> "id": 1,> "method": "eth_subscribe",> "params": [> "syncing"> ]> }

Request fields

Subscription request

FieldTypeRequiredNotes
jsonrpcstringRequiredJSON-RPC version. Use `2.0`.
idstring | numberRequiredCaller request id.
methodstringRequiredAllowlisted subscription method.
paramsarrayRequiredSubscription topic or filter arguments.

Response fields

Subscribe result

FieldTypeNotes
jsonrpcstringJSON-RPC version.
idstring | numberEchoed caller request id.
resultstring | numberSubscription id returned by the hosted route.

Notification shape

FieldTypeNotes
methodstringNotification method such as `eth_subscription` or `slotNotification`.
params.subscriptionstring | numberSubscription id tied to the current stream.
params.resultobjectUpstream chain payload for the current notification.