Connect over JSON-RPC WebSocket

Connect to a MEVX-operated BSC node over WebSocket for standard JSON-RPC
calls and real-time subscriptions.

Supported Methods and CU Cost

WebSocket billing is based on delivered data. Successful billable responses and
notifications use 5 CU per 100,000 JSON bytes delivered.

MethodCU cost
eth_blockNumber5 CU / 100 KB
eth_call5 CU / 100 KB
eth_chainId5 CU / 100 KB
eth_createAccessList5 CU / 100 KB
eth_estimateGas5 CU / 100 KB
eth_feeHistory5 CU / 100 KB
eth_gasPrice5 CU / 100 KB
eth_getBalance5 CU / 100 KB
eth_getBlockByHash5 CU / 100 KB
eth_getBlockByNumber5 CU / 100 KB
eth_getBlockReceipts5 CU / 100 KB
eth_getBlockTransactionCountByHash5 CU / 100 KB
eth_getBlockTransactionCountByNumber5 CU / 100 KB
eth_getCode5 CU / 100 KB
eth_getFinalizedBlock5 CU / 100 KB
eth_getFinalizedHeader5 CU / 100 KB
eth_getRawTransactionByHash5 CU / 100 KB
eth_getStorageAt5 CU / 100 KB
eth_getTransactionByBlockHashAndIndex5 CU / 100 KB
eth_getTransactionByBlockNumberAndIndex5 CU / 100 KB
eth_getTransactionByHash5 CU / 100 KB
eth_getTransactionCount5 CU / 100 KB
eth_getTransactionReceipt5 CU / 100 KB
eth_getUncleCountByBlockHash5 CU / 100 KB
eth_getUncleCountByBlockNumber5 CU / 100 KB
eth_maxPriorityFeePerGas5 CU / 100 KB
eth_mining5 CU / 100 KB
eth_sendRawTransaction5 CU / 100 KB
eth_syncing5 CU / 100 KB
net_listening5 CU / 100 KB
net_peerCount5 CU / 100 KB
net_version5 CU / 100 KB
web3_clientVersion5 CU / 100 KB
web3_sha35 CU / 100 KB

Subscriptions

MethodSubscription typeCU cost
eth_subscribenewHeads5 CU / 100 KB
eth_subscribelogs5 CU / 100 KB
eth_unsubscribe0 CU

eth_unsubscribe remains available after CU quota exhaustion so clients can
release subscriptions. The credential must remain active, the subscription must
belong to the current WebSocket session, and request-rate limits still apply.

For logs, include a non-empty address or topics filter. Pending-transaction,
Trace, Debug, transaction-pool, filter, proof, blob-sidecar, broad log-scan, and
unbounded multi-call methods are denied by default.

Connect

wscat -c "wss://api.mevx.io/saas/ws/v1/bsc" 
  -H "X-API-KEY: YOUR_API_KEY"

Send one JSON-RPC object per text message:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_subscribe",
  "params": ["newHeads"]
}

Browser WebSocket clients cannot add the X-API-KEY handshake header. Connect
from your backend to keep the key out of client-side code.

Session Rules

  • Batches and binary messages are not supported
  • Maximum inbound message size: 1 MiB; maximum outbound message size: 10 MiB
  • Respond to server pings with pongs
  • Reconnect with backoff and recreate subscriptions
  • Process messages promptly; slow consumers are disconnected
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Canonical lowercase network slug. Chain access is granted by package tier, not per credential.

Allowed:
Responses
101

Connection established. The client can now exchange JSON-RPC 2.0 text messages over the WebSocket.

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json