Follow the accounts and signatures your application watches.
Watch selected accounts, transaction signatures and logs. One open connection pushes updates to your listener, wallet or dashboard.
Use WebSocket for selected accounts and signatures. For many streams, busy programs or full-state indexing, explore gRPC.
The server returns a subscription ID. Notifications use that ID on the same connection until you unsubscribe or the connection ends. Signature subscriptions finish after one notification.
Your Bundle token admits the connection at the Frankfurt endpoint.
Send a method, filter and commitment. Save the returned ID.
Process notifications for your active subscriptions.
Send the subscription ID to the matching unsubscribe method.
Most subscriptions accept a commitment. The documented default is finalized.
Earlier local state. Treat it as provisional.
Use when your app needs confirmed updates.
Use when your app needs finalized state.
Compare the supported subscriptions and shared-plan restrictions below. For higher-volume streaming, explore gRPC.
| Subscription | Delivered to your app | Scope on shared plans |
|---|---|---|
accountSubscribe | Changes to one account's state. | One subscription per account. |
signatureSubscribe | A transaction signature reaches your chosen commitment. | One-shot. Removed after its notification. |
logsSubscribe | Transaction logs matching your filter. | Mention filter required; all-transaction logs are blocked. |
programSubscribe | Account changes for a program you follow. | A dataSize or memcmp filter is required. |
slotSubscriberootSubscribe | New slots or new roots (finalized slots). | Lightweight chain progress notifications. |
For apps with a defined account list and modest request volume.
Free trial up to 24h on request; our team confirms availability and setup. Solana wallet and USDC portal balance for purchase.
Prices buy the whole Solana Bundle for 30 days. STARTER includes RPC + WebSocket. FOCUS and higher add gRPC; GROW and PROFESSIONAL also include Frankfurt ShredStream Raw.
| Bundle | Concurrent WS connections | Subscriptions per connection | Total subscriptions per plan | RPS budget |
|---|---|---|---|---|
| STARTER | 10 | 100 | 1,000 | 15 |
| FOCUS | 20 | 100 | 5,000 | 25 |
| BUILD | 30 | 100 | 5,000 | 200 |
| GROW | 40 | 500 | 10,000 | 300 |
| PROFESSIONAL | 70 | 1,000 | 25,000 | 500 |
The total subscription cap applies across all connections. Keep connection count, subscriptions per connection and total subscriptions within their respective limits.
Subscribe and unsubscribe commands count against the RPS budget, alongside RPC requests. RPS is measured over a 10-second sliding window.
Frankfurt endpoint: wss://fra.sol.supanode.xyz:8900
The Bundle token also authenticates RPC and included gRPC access.
# Install wscat first. Token stays in your environment.
wscat -c wss://fra.sol.supanode.xyz:8900 \
-H "x-token: $SUPANODE_TOKEN"
# After connecting, send this JSON:
{"jsonrpc":"2.0","id":1,
"method":"accountSubscribe",
"params":["YOUR_ACCOUNT_PUBKEY",
{"commitment":"confirmed","encoding":"base64"}]}Illustrative CLI example. Replace the account placeholder and add your token when connecting.
A 30-60 second ping interval helps detect half-open sockets. The documented idle timeout is 10 minutes.
Start retry delay at 1 second and cap it at 30 seconds. Save subscription intent; returned IDs do not survive reconnects.
Re-read accounts after a gap. For a signature, fall back to getSignatureStatuses if the socket drops or a notification times out.
Building a browser app? A native browser WebSocket cannot set custom handshake headers. Docs show an api-key query option for clients such as web3.js, but URLs can enter logs. Your Bundle token grants quota access: keep it out of public client bundles. Use your backend to hold the token and relay the data your app needs.
Match the data volume, client and recovery behaviour to your application.
Shared-plan Docs list blockSubscribe, voteSubscribe and slotsUpdatesSubscribe as blocked. logsSubscribe("all") and logsSubscribe("allWithVotes") are blocked, and program subscriptions need a dataSize or memcmp filter. Confirm subscription edge cases with support before depending on them. See current restrictions.
Check the transaction error field in each signature notification to verify execution at the requested commitment. After sendTransaction accepts a transaction, use a signature subscription or RPC status lookup to track the result.
Consider gRPC for many account or transaction streams, busy program feeds or full-state indexing. WebSocket is the lighter path for a selected set of things to watch. For recovery history, use RPC with its two-day replay window or gRPC with its 100-slot replay window.
WebSocket is included with STARTER, FOCUS, BUILD, GROW and PROFESSIONAL. Pick a Bundle by its connection, subscription and shared RPS limits. gRPC is included from FOCUS.
Trial access ends at the agreed time. Purchase a paid 30-day Bundle in the portal to continue. Trials run for up to 24 hours on request, with availability and setup confirmed by our team. No credit card is required.