GET /v1/stream/balance-history

Stream incremental wallet balance history while the backend reconstructs the full result.

This is the SSE companion to GET /v1/history/balance.

You can get a free Helius RPC at helius.dev.

Request

GET /v1/stream/balance-history?walletAddress=<pubkey>&heliusRpcUrl=<urlencoded>&assetMint=SOL
x-api-key: YOUR_API_KEY

Query parameters

Field	Type	Required	Default	Description
walletAddress	string	Yes	—	Base58 Solana wallet address
heliusRpcUrl	string	Yes	—	Full HTTPS Helius RPC URL including API key
assetMint	string	No	SOL	SOL, a tracked token symbol like USDC, or a base58 SPL mint address
apiKey	string	No	—	Query-param auth fallback for SSE clients that cannot set headers

Events

Event	Description
ready	Stream accepted
progress	Rough phase-based progress estimate
points	Newly discovered balance points batch
complete	Final full result
heartbeat	Connection keepalive
error	Terminal compute error

Progress phases

Phase	Meaning
seed	Initial newest-history seed loaded
enumerate	Signature discovery complete
hydrate	Full transaction windows being hydrated
repair	Final missing-slot repair pass
complete	Final result ready

Notes

• points batches arrive in discovery order, not guaranteed final sorted order.
• Deduplicate by signature and sort by (slot, transactionIndex) client-side for stable charts.
• Browser-native EventSource cannot set custom headers; ?apiKey= is supported for that case.
• Prefer header auth when possible; use ?apiKey= as a compatibility fallback.

Example

curl -N "https://api.venum.dev/v1/stream/balance-history?walletAddress=EbUNi6setNdX7a89j4i1nVF9Cnw6puSFJk7Fjrnnxfe2&heliusRpcUrl=https%3A%2F%2Fmainnet.helius-rpc.com%2F%3Fapi-key%3DYOUR_HELIUS_KEY&assetMint=SOL&apiKey=YOUR_API_KEY"

Tracked token symbols are also accepted:

curl -N "https://api.venum.dev/v1/stream/balance-history?walletAddress=EbUNi6setNdX7a89j4i1nVF9Cnw6puSFJk7Fjrnnxfe2&heliusRpcUrl=https%3A%2F%2Fmainnet.helius-rpc.com%2F%3Fapi-key%3DYOUR_HELIUS_KEY&assetMint=USDC&apiKey=YOUR_API_KEY"

See GET /v1/tokens for the current list of supported tracked token symbols.

Errors

See the companion REST page GET /v1/history/balance for validation details.