Home

MONAD WSS API

v1.0.0
Base URL
wss://monad.nownodes.io/wss/{apiKey}NOWNodes MONAD (Ethereum L1) WSS endpoint. Replace {apiKey} with your NOWNodes API key - it is passed as the last path segment of the WebSocket URL.

WebSocket (WSS) interface of the NOWNodes MONAD endpoint: wss://monad.nownodes.io/wss/{apiKey}. Connect with your NOWNodes API key as the last path segment of the URL, then send JSON-RPC 2.0 requests as text messages; responses and subscription notifications arrive on the same connection. Every documented method is one operation below (the /wss/{apiKey} (method) paths are mnemonics for the single WebSocket message channel, not separate HTTP routes).

Method set: subscriptions (eth_subscribe / eth_unsubscribe with newHeads, logs, newPendingTransactions and minedTransactions event streams), chain and status, gas and fees (including EIP-1559 fee history and priority fee), blocks, transactions and receipts, account state (balance, code, storage, call, proofs, access lists), filters and logs, transaction signing and broadcast, and node/network introspection (net_*, web3_*).

Authentication

wssApiKeyapiKey

NOWNodes API key passed as the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}). Modeled as a query-parameter key because OpenAPI has no dedicated path-position API key; on the wire the key is part of the URL path. The key must not be published in shared examples.

API Key: apiKey in query

WSS

Subscriptions

Pub/sub event streams (newHeads, logs, newPendingTransactions, minedTransactions).

Subscribe to event streams (newHeads, logs, newPendingTransactions, minedTransactions).

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_subscribe)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Starts a subscription to one of the event types: newHeads (new block headers), logs (with an optional filter object {address, topics}), newPendingTransactions (pending transaction hashes) or minedTransactions (transaction objects as they are mined). The server answers with a subscription id and then pushes eth_subscription notifications carrying that id. Only available on WebSocket connections.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_subscribe, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Cancel an active subscription.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_unsubscribe)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Cancels a subscription created with eth_subscribe, passing the subscription id as the first parameter. Returns true when the subscription was active and is now cancelled.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_unsubscribe, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Chain & Status

Chain id, block number, sync status.

Returns the configured chain id.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_chainId)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the currently configured chain id used in replay-protected (EIP-155) transaction signing. Monad mainnet chain id is 0x8f (143).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_chainId, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the number of the most recent block.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_blockNumber)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of the most recent block as a hex string.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_blockNumber, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the node sync status.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_syncing)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns false when the node is fully synced, or a progress object with startingBlock / currentBlock / highestBlock while syncing.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_syncing, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Gas & Fees

Gas price, estimates, EIP-1559 fee history.

Returns the current gas price.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_gasPrice)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns an estimate of the current gas price in wei.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_gasPrice, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Estimates the gas needed for a transaction.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_estimateGas)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Generates and returns an estimate of how much gas is necessary for the transaction to complete. The transaction is not added to the chain; the estimate can exceed the actually used gas.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_estimateGas, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the current priority fee estimate.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_maxPriorityFeePerGas)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns a fee per gas that is an estimate of how much can be paid as a priority fee (tip) to get a transaction included in the current block.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_maxPriorityFeePerGas, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns historical gas fee information.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_feeHistory)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the base fee per gas and gas used ratio for a range of blocks, plus priority fee percentiles when requested. Parameters: blockCount (hex), newestBlock (tag or hex), reward percentiles (array of numbers 0-100, optional).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_feeHistory, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Blocks

Block lookups and counters.

Returns a block by hash.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getBlockByHash)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about a block by hash. The second parameter controls whether transactions are returned as full objects (true) or hashes (false). Returns null for an unknown hash.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getBlockByHash, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns a block by number.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getBlockByNumber)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about a block by block number (hex) or tag (latest, earliest, pending, safe, finalized). The second parameter controls full transactions versus hashes.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getBlockByNumber, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the transaction count of a block by hash.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getBlockTransactionCountByHash)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of transactions in the block matching the given hash (null for an unknown hash).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getBlockTransactionCountByHash, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the transaction count of a block by number.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getBlockTransactionCountByNumber)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of transactions in the block matching the given block number.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getBlockTransactionCountByNumber, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns an uncle block by block hash and index.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getUncleByBlockHashAndIndex)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about an uncle of a block by hash and uncle index position. Proof-of-stake / L2 chains have no uncles; the result is null for any index.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getUncleByBlockHashAndIndex, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns an uncle block by number and index.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getUncleByBlockNumberAndIndex)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about an uncle of a block by number and uncle index position; null on Monad.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getUncleByBlockNumberAndIndex, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the number of uncles of a block by hash.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getUncleCountByBlockHash)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of uncles in the block matching the given hash (null for an unknown hash; Monad blocks have no uncles).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getUncleCountByBlockHash, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the number of uncles of a block by number.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getUncleCountByBlockNumber)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of uncles in the block matching the given number; 0x0 on Monad (no uncles).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getUncleCountByBlockNumber, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Transactions

Transaction lookups, nonces, receipts, pending pool.

Returns a transaction by hash.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getTransactionByHash)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the information about a transaction requested by transaction hash (pending or mined); null for an unknown hash.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getTransactionByHash, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns a transaction by block hash and index.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getTransactionByBlockHashAndIndex)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about a transaction by block hash and transaction index position; null when the block or index is unknown.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getTransactionByBlockHashAndIndex, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns a transaction by block number and index.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getTransactionByBlockNumberAndIndex)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns information about a transaction by block number (or tag) and transaction index position.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getTransactionByBlockNumberAndIndex, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the nonce (transaction count) of an address.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getTransactionCount)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of transactions sent from an address, optionally filtered by block tag.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getTransactionCount, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns a transaction receipt by hash.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getTransactionReceipt)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the receipt of a mined transaction by transaction hash (null while pending or unknown).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getTransactionReceipt, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the pending transactions of the node.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_pendingTransactions)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the transactions currently pending in the node transaction pool (empty array when the pool is empty).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_pendingTransactions, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Accounts & State

Balance, code, storage, calls, proofs, access lists.

Returns the balance of an address.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getBalance)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the balance of the account of the given address in wei, optionally at a block tag.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getBalance, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the contract code at an address.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getCode)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the code at a given address (0x for plain accounts), optionally at a block tag.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getCode, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns a storage value of a contract.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getStorageAt)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the value from a storage position at a given address (32-byte hex word).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getStorageAt, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Executes a message call without creating a transaction.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_call)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Executes a new message call immediately without creating a transaction on the chain. Parameters: call object {from?, to, gas?, gasPrice?, value?, data?} and a block tag.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_call, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns an account and storage Merkle proof.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getProof)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the account and storage values of the specified account, including a Merkle proof. Parameters: address, array of storage keys, block tag.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getProof, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Estimates an EIP-2930 access list for a transaction.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_createAccessList)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the list of addresses and storage keys read and written by the transaction (except the sender and precompiles), plus the estimated gas consumed when the access list is added.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_createAccessList, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Filters & Logs

Polling filters and log queries.

Creates a log filter.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_newFilter)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Creates a filter object based on filter options ({fromBlock, toBlock, address, topics}) to notify when the state changes (logs). Use eth_getFilterChanges to poll it.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_newFilter, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Creates a new-block filter.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_newBlockFilter)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Creates a filter in the node to notify when a new block arrives; poll it with eth_getFilterChanges.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_newBlockFilter, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Creates a pending-transaction filter.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_newPendingTransactionFilter)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Creates a filter in the node to notify when new pending transactions arrive; poll it with eth_getFilterChanges.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_newPendingTransactionFilter, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Removes a filter.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_uninstallFilter)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Uninstalls a filter with the given id; should always be called when the filter is no longer needed.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_uninstallFilter, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Polls a filter for changes.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getFilterChanges)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Polling method for a filter, returning an array of logs (log filters) or block/transaction hashes (block / pending-transaction filters) which occurred since the last poll.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getFilterChanges, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns all logs of a filter.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getFilterLogs)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns an array of all logs matching the filter with the given id (created with eth_newFilter).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getFilterLogs, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns logs matching a filter object.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_getLogs)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns an array of all logs matching the given filter object ({fromBlock, toBlock, address, topics, blockHash}).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_getLogs, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Signing & Broadcast

Transaction signing and broadcast (write operations).

Broadcasts a signed raw transaction.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_sendRawTransaction)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Creates a new message call transaction or a contract creation for signed transactions. WRITE operation: the error example shows the standard RLP validation failure for a malformed payload.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_sendRawTransaction, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Sends a transaction from a node-managed account.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_sendTransaction)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Creates a new message call transaction or a contract creation. Requires the sender account to be managed by the node; NOWNodes endpoints do not manage accounts, so the call answers with the unknown account error. WRITE operation.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_sendTransaction, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Signs a message with a node-managed account.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_sign)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Calculates an Ethereum-specific signature: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)). Requires a node-managed account, so public endpoints answer with the unknown account error.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_sign, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Signs a transaction with a node-managed account.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_signTransaction)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Signs a transaction object with a node-managed account. Public endpoints do not manage accounts; the error example shows the validation error for an incomplete transaction object.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_signTransaction, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Network & Node

Node and network introspection (net_*, web3_*, eth_coinbase).

Returns the node coinbase / fee recipient.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (eth_coinbase)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the coinbase address (fee recipient; on the PoS L1 the validator block proposer) of the node.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for eth_coinbase, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the network id.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (net_version)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the current network id. Monad mainnet network id is 143 (decimal string).

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for net_version, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns whether the client is listening.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (net_listening)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns true if the client is actively listening for network connections.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for net_listening, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the number of connected peers.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (net_peerCount)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the number of peers currently connected to the client, as a hex string.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for net_peerCount, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns the client version.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (web3_clientVersion)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns the web3 client version string of the node.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for web3_clientVersion, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.

Returns Keccak-256 of the given data.

POST
wss://monad.nownodes.io/wss/{apiKey}/wss/{apiKey} (web3_sha3)

Authorizations

ApiKeyAuthApiKeyAuth

apiKey string

NOWNodes API key passed in the api-key header.

Returns Keccak-256 (not the standardized SHA3-256) of the given data.

Sent as a JSON text message over the WebSocket connection wss://monad.nownodes.io/wss/{apiKey}.

Body

application/json

WebSocket request envelope for web3_sha3, sent as a JSON text message.

WebSocket text-message request envelope sent over the single WSS connection.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarray | object

Method parameters (array or object); omit for parameterless methods.

idinteger | string

Client-chosen request identifier echoed in the response.

Parameters

apiKeystringrequiredpath

NOWNodes API key - the last path segment of the WebSocket URL (wss://monad.nownodes.io/wss/{apiKey}).

Response

200OK

Response delivered on the same WebSocket connection. JSON-RPC errors arrive as regular messages (no HTTP status change); subscription pushes arrive as eth_subscription notifications.