Published by TOSScoin Research

Whale Alert Streaming: Real-Time Large Trade Monitoring

Key Findings

1) Birdeye WebSocket supports direct large-trade streaming by USD threshold

• Sources:
  • https://docs.birdeye.so/docs/websocket
  • https://docs.birdeye.so/docs/subscribe_large_trade_txs
• Findings:
  • SUBSCRIBE_LARGE_TRADE_TXS supports min_volume (required) and optional max_volume filters.
  • Stream output includes owner, pool address, tx hash, volumeUSD, network, and base/quote token details.
  • Only swap transactions are included in this stream.
• Why it matters: Gives an immediate whale-flow lane without polling token APIs.

2) Birdeye tx streams can be scoped by token/pair and tx type, including multi-address complex queries

• Source: https://docs.birdeye.so/docs/subscribe_txs
• Findings:
  • SUBSCRIBE_TXS supports token address, pair address, or complex query logic.
  • Supports tx type filtering (swap, add_liquidity, remove_liquidity, etc.).
  • Complex query mode supports broad multi-target monitoring and up to 100 addresses.
• Why it matters: Enables one stream to watch multiple token cohorts and liquidity behavior in real time.

3) Birdeye wallet stream is a direct "watch this wallet" feed

• Source: https://docs.birdeye.so/docs/subscribe_wallet_txs
• Findings:
  • SUBSCRIBE_WALLET_TXS tracks transactions for a specific wallet address.
  • Returns normalized fields (tx type, volumeUSD, network, base/quote assets, timestamps).
• Why it matters: Practical for tracking known whale wallets or KOL wallets tied to meme rotations.

4) Helius webhooks add durable, server-side filtering at scale

• Sources:
  • https://www.helius.dev/docs/webhooks
  • https://www.helius.dev/docs/api-reference/webhooks/create-webhook
  • https://www.helius.dev/docs/webhooks/transaction-types
  • https://www.helius.dev/docs/faqs/webhooks
• Findings:
  • Create webhooks with up to 100,000 monitored addresses and specific transaction-type filters.
  • Supports enhanced/raw/discord webhook modes and auth header verification.
  • FAQ documents retry behavior (up to 3 retries, 1-minute interval) and duplicate-delivery expectation.
• Why it matters: Improves reliability for always-on alerting and gives clearer idempotency requirements for alert processors.

Suggested Workflow

1. Use Birdeye SUBSCRIBE_LARGE_TRADE_TXS for immediate whale burst detection.
2. Mirror critical addresses into Helius enhanced webhooks for durable, filterable backend alerts.
3. Build idempotent processing keyed by transaction signature/hash (to handle retries/duplicates).
4. Route high-value alerts (e.g., large sell waves in concentrated tokens) into summary dashboards and decision notes.

Sources

• https://docs.birdeye.so/docs/websocket
• https://docs.birdeye.so/docs/subscribe_large_trade_txs
• https://docs.birdeye.so/docs/subscribe_txs
• https://docs.birdeye.so/docs/subscribe_wallet_txs
• https://www.helius.dev/docs/webhooks
• https://www.helius.dev/docs/api-reference/webhooks/create-webhook
• https://www.helius.dev/docs/webhooks/transaction-types
• https://www.helius.dev/docs/faqs/webhooks