Skip to main content

RPC / API Matrix

InterfaceStatusBest ForTransportProduction Notes
JSON-RPC HTTPStandardReads, transaction submission, stateless service callsHTTP on 8545Execution-layer JSON-RPC is the common app API documented by ethereum.org and execution-apis; place behind auth and rate limits.
JSON-RPC WebSocketStandardeth_subscribe streams for heads and logsWebSocket on 8546Geth serves WebSocket RPC on default port 8546 and it is suited to subscriptions per Geth RPC docs; implement reconnect/backfill.
Beacon APIStandard, internal/protectedConsensus state, finality, validator/operator monitoringHTTP REST on 5052The beacon-APIs spec warns not to expose it unprotected to the public internet.
Engine APIInternalExecution/consensus payload exchangeAuthenticated HTTP on 8551JWT-authenticated internal channel; never route through public ingress.
Debug/Trace APIAdvancedTransaction tracing, incident analysis, indexer backfillsJSON-RPC modules over HTTP/IPCDisable by default; isolate because calls are expensive and may expose sensitive node behavior.
GraphQLOptionalAd hoc query-shaped reads where supportedHTTPClient-specific support; prefer JSON-RPC for portable integrations.