WebSocket Endpoint
Subscribe
Filter Parameters
Filter by sender wallet address.
Filter by recipient wallet address.
Filter by token mint address, or
"Solana" for native SOL transfers.Minimum transfer amount filter.
Maximum transfer amount filter.
Subscription Confirmation
Transfer Event Response
Response Fields
Transfer Information
- from / to — The sender and recipient wallet addresses for the transfer.
- amount — The raw transfer amount in the token’s smallest unit. Divide by
10^decimalsfor the human-readable value. - token — Either
"Solana"for native SOL transfers or the SPL token mint address. - decimals — The number of decimal places for the token (9 for SOL, 6 for USDC, etc.).
Transaction Details
- transaction_signature — Full Solana transaction signature for on-chain verification.
- block_num / block_time — Block number and timestamp for ordering and time-based analysis. Note that these are returned as strings for this stream.
Unsubscribe
Request
Response
Code Examples
Use Cases
Wallet Cluster Analysis
- Track transfer patterns between related wallets to identify wallet clusters and fund flows.
- Build graph-based models of wallet relationships using sender/receiver connections.
- Detect wash trading by identifying circular transfer patterns between a small set of wallets.
- Monitor known wallets (exchanges, protocols, whales) to track capital movements.
Security Monitoring
- Set up alerts for large transfers using
min_amountto detect significant fund movements. - Monitor specific wallets using
from_addressorto_addressfilters for real-time notifications. - Track rapid outflows from a single wallet, which may indicate a compromised account.
- Detect unusual transfer patterns such as many small transfers to a single address (dusting attacks).
Portfolio Tracking
- Subscribe to your own wallet addresses to get real-time notifications of incoming and outgoing transfers.
- Track specific token transfers using the
tokenfilter for portfolio management. - Build historical transfer records for accounting and tax reporting.
- Monitor token distribution events by tracking transfers from known airdrop or vesting wallets.
Best Practices
- Use filters to reduce message volume in production. Subscribing to all transfers generates high throughput.
- Convert raw amounts to human-readable values by dividing by
10^decimalsbefore displaying or storing. - Remember that
block_numandblock_timeare returned as strings in this stream — parse them to integers for numerical operations. - Implement reconnection logic with exponential backoff to handle temporary connection drops.
- Store transfer data with proper indexing on
from,to, andtokenfields for efficient querying. - Set up separate subscriptions for different monitoring concerns (e.g., one for whale alerts, one for portfolio tracking) to keep processing logic clean.
