GET /v1/stream/pools
Stream new pool discoveries in real time.
Requires API key and starter plan or above.
If you only need a recent snapshot instead of realtime updates, use GET /v1/pools/new.
Request
http
GET /v1/stream/pools
x-api-key: YOUR_API_KEYBrowser-native EventSource cannot set custom headers. For browser clients, use ?apiKey=YOUR_API_KEY instead.
Events
| Event | Description |
|---|---|
new-pool | Newly discovered pool |
heartbeat | Connection keepalive |
Example payload
text
event: new-pool
data: {"address":"HJPj...","dex":"raydium-cpmm","mintA":"So111...","mintB":"EPjF...","discoveredAt":1712000000000}Example
bash
curl -N -H "x-api-key: YOUR_API_KEY" \
"https://api.venum.dev/v1/stream/pools"
# Browser/EventSource fallback
curl -N \
"https://api.venum.dev/v1/stream/pools?apiKey=YOUR_API_KEY"Errors
| Status | Description |
|---|---|
401 | Missing or invalid API key |
403 | Pool stream requires starter plan or above |
429 | SSE connection limit exceeded |
Rate Limit
Counts against the SSE streams connection limit in Plans & Rate Limits.