network: "base" chain_id: 8453 guide: "ws" availability: "unknown" validation: "positive_fixture" evidence_kind: "source_summary" tier_min: "basic" tier_provisional: true
Base JSON-RPC WebSocket
Base JSON-RPC Pub/Sub over WebSocket:
newHeadson/ws/base. Minimum tier: Basic.
Endpoint and plans: Base RPC endpoint.
The public keyed endpoint is {WSSBase}/ws/base/{key}, normalized to /ws/base with scope base:ws, and it is reachable from Basic with an ordinary Triport key.
newHeads is the topic served on /ws/base. For contract events, poll eth_getLogs or use the Flashblocks feed with an address filter.
Missing, expired, revoked, or wrong-scope credentials must be rejected before upstream dial; revocation terminates active fanout.
Topics
| Topic | Minimum tier |
|---|---|
newHeads | Basic |
Subscribe envelope
This body matches the frozen AsyncAPI SubscribeRequest. The route /ws/base is mounted on both production PoPs (EU and CA): a WebSocket upgrade returns 101, measured 2026-09-22, re-checked 2026-10-10.
{
"jsonrpc": "2.0",
"id": 1,
"method": "eth_subscribe",
"params": ["newHeads"]
}Notifications use {"jsonrpc":"2.0","method":"eth_subscription","params":{"subscription":"…","result":…}}.
See the Base WS AsyncAPI and the normalized Flashblocks guide.