tomevault-io ave-data-wss
Live on-chain data streams via the AVE Cloud WebSocket API. For shared connection discipline and response rules, see operator-playbook.md.
Setup
export AVE_API_KEY="your_api_key_here"
export API_PLAN="pro"
pip install -r scripts/requirements.txt
Rate Limits
All WebSocket streams require API_PLAN=pro (20 TPS). Connection discipline matters more than TPS: keep one REPL or server connection open, switch topics with subscribe / unsubscribe, and avoid stacking parallel sockets unless there is a hard need.
Supported Chains
All Data REST chains are supported for streaming, including bsc, eth, base, solana, tron, polygon, arbitrum.
Operations
REPL
Use one interactive connection for multi-topic monitoring.
python scripts/ave_data_wss.py wss-repl
| Command | Description |
|---|---|
subscribe price <addr-chain> [...] |
Stream live price changes for one or more tokens |
| `subscribe tx [tx | multi_tx |
subscribe kline <pair> <chain> [interval] |
Stream live candle updates for a pair |
unsubscribe |
Cancel the current subscription |
quit |
Close the connection and exit |
Watch tx
Stream live swap or liquidity events for a pair.
python scripts/ave_data_wss.py watch-tx --address <pair_address> --chain <chain> [--topic tx]
Watch kline
Stream live kline updates for a pair.
python scripts/ave_data_wss.py watch-kline --address <pair_address> --chain <chain> [--interval k60] [--format raw|markdown]
Watch price
Stream live price changes for one or more tokens.
python scripts/ave_data_wss.py watch-price --tokens <addr1>-<chain1> [<addr2>-<chain2> ...]
Server daemon
Start or stop the reusable Docker-backed connection.
python scripts/ave_data_wss.py start-server
python scripts/ave_data_wss.py stop-server
python scripts/ave_data_wss.py serve
Workflow Example
Monitor token launch via REPL
Open one connection, watch swaps, then switch to price without opening a second socket.
python scripts/ave_data_wss.py wss-repl
# at the prompt:
subscribe tx <pair_address> bsc
unsubscribe
subscribe price <token_address>-bsc
quit
Reference
Use shared references for operator rules, recovery patterns, response style, and the full streaming API surface.
- operator-playbook.md
- error-translation.md
- response-contract.md
- presentation-guide.md
- learn-more.md
- data-api-doc.md
Source: AveCloud/ave-cloud-skill — distributed by TomeVault.