📘
Note:
The free plan offers 2GB of wss traffic per billing cycle for receiving messages from all subscribed methods. Once the traffic limit is exceeded, you will need to upgrade to a paid plan to continue using the service.

What are WebSockets and how do they differ from HTTP requests?

WebSockets is a bidirectional communication protocol that maintains a network connection between two parties, typically a server and a client. Unlike HTTP, with WebSockets clients don't need to make requests when they want information continuously.

Instead, in an open WebSocket connection, a server can push network updates to clients by allowing them to subscribe to certain network states, such as new slots from the blockchain.

📘
Note:
If there is no message interaction between the client and server within 5 minutes after the WebSocket connection is established, the server will actively disconnect. In such cases, the client needs to initiate the connection again.

How can I set up a WebSocket connection?

It’s quite simple to set up a new WebSocket connection to Solana - try the command below in your terminal.

wscat -c wss://api.zan.top/node/ws/v1/solana/devnet/{APIKEY}

wscat -c wss://api.zan.top/node/ws/v1/solana/mainnet/{APIKEY}

If you’d like an endpoint with higher rate limits in Solana, please contact us.

After connecting to the RPC PubSub WebSocket at wss://<ADDRESS>/:

Submit subscription requests to the WebSocket using the methods below
Multiple subscriptions may be active at once

How can I make WebSocket subscriptions for Solana blockchain reliable?

Once you’ve run the command above, you’ll have an open WebSocket connection to a Solana node. To start/stop receiving push updates on certain state changes in the Solana network, you may need to send one of the following methods:

Subscribe
Unsubscribe

These two requests enable blockchain app developers to create and delete subscriptions. By setting their parameters properly, you’ll get push updates whenever new slots are sent or new blocks are created.

However, please note that due to the high block production speed and high traffic of Solana nodes, the WebSocket connection may occasionally disconnect during node maintenance. Users need to actively manage exceptions and resubscribe when the connection is lost.

Methods	Subscribe	Unsubscribe
account	accountsubscribe	accountunsubscribe
block	blocksubscribe	blockunsubscribe
logs	logssubscribe	logsunsubscribe
program	programsubscribe	programunsubscribe
root	rootsubscribe	rootunsubscribe
signature	signaturesubscribe	signatureunsubscribe
slot	slotsubscribe	slotunsubscribe
slotsUpdates	slotsupdatessubscribe	slotsupdatesunsubscribe
vote	votesubscribe	voteunsubscribe

Connection Quotas and Limits

To ensure service stability and fair usage, our WebSocket service implements the following quota limits:

Quota Item	Testnet	Mainnet	Description
Maximum WebSocket Connections	20 concurrent connections	40 concurrent connections	Maximum parallel connections limit
Subscriptions per Connection	20 concurrent connectionsNo hard limit	40 concurrent connections	Recommended to control reasonably to maintain connection stability
Connection Keep-Alive Time	Automatically disconnected after 5 minutes of inactivity	Automatically disconnected after 5 minutes of inactivity	Heartbeat maintenance required

📘
Note:

For enterprise users with special requirements, we offer configurable quota plans. Please contact us for customized services.

For scenarios where Solana's native getProgramAccounts may encounter performance or reliability issues, please use our interface specifications and performance metrics as the definitive reference.

WSS Billing Instructions

Subscriptions for Solana are billed according to the number of push messages received. Different subscription methods consume varying amounts of Credits per push, as detailed in Solana's Credit pricing details.