Streams (SSE)

Real-time data via Server-Sent Events. Venum's stream endpoints keep one long-lived HTTP connection open and push updates as they happen.

Endpoints

• GET /v1/stream/prices — live token prices
• GET /v1/stream/pools — new pool discoveries
• GET /v1/stream/tx — transaction lifecycle updates
• GET /v1/stream/balance-history — incremental wallet balance history

Shared Notes

• Streams require an API key.
• Long-lived SSE connections count against the SSE streams connection limit in the plan table.
• All public stream routes accept either x-api-key or ?apiKey=.
• Browser-native EventSource cannot set custom headers. For browser clients, use ?apiKey=, fetch() streaming, or an EventSource polyfill that supports headers.
• Clients should reconnect on disconnect and handle duplicate terminal events idempotently.