newPendingTransactions

Receive one notification for each pending transaction hash on the hosted EVM route.

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 pending transaction subscription

Handles

Surface	Label	Value
`raw_rpc_ws`	Endpoint	`wss://gw-aql.tomo.services/rpc/ethereum/wss`
`raw_rpc_ws`	Auth header	`Bearer <api_key>`
`raw_rpc_ws`	Subscribe method	`eth_subscribe`
`raw_rpc_ws`	Notification method	`eth_subscription`

Use `newPendingTransactions` when the runtime needs early transaction visibility before the transaction is included in a block.

Examples use `/rpc/ethereum/wss`. The same reviewed topic set applies across the current public EVM websocket routes in the gateway baseline.

Examples

Connect with wscat


wscat -c "wss://gw-aql.tomo.services/rpc/ethereum/wss" \  -H "Authorization: Bearer <api_key>"> {>   "jsonrpc": "2.0",>   "id": 1,>   "method": "eth_subscribe",>   "params": [>     "newPendingTransactions">   ]> }

Request fields

Subscription request

Field	Type	Required	Notes
`jsonrpc`	`string`	Required	JSON-RPC version. Use `2.0`.
`id`	`string \| number`	Required	Caller request id.
`method`	`string`	Required	Allowlisted subscription method.
`params`	`array`	Required	Subscription topic or filter arguments.

Response fields

Subscribe result

Field	Type	Notes
`jsonrpc`	`string`	JSON-RPC version.
`id`	`string \| number`	Echoed caller request id.
`result`	`string \| number`	Subscription id returned by the hosted route.

Notification shape

Field	Type	Notes
`method`	`string`	Notification method such as `eth_subscription` or `slotNotification`.
`params.subscription`	`string \| number`	Subscription id tied to the current stream.
`params.result`	`object`	Upstream chain payload for the current notification.