Ave Data Wss

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](../../references/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 [...] | Stream live price changes for one or more tokens | | subscribe tx [tx|multi_tx|liq] | Stream swap or liquidity events for a pair | | subscribe kline [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  --chain  [--topic tx]

Watch kline

Stream live kline updates for a pair.

python scripts/ave_data_wss.py watch-kline --address  --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 - [- ...]

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  bsc
unsubscribe
subscribe price -bsc
quit

Reference

Use shared references for operator rules, recovery patterns, response style, and the full streaming API surface.

• [operator-playbook.md](../../references/operator-playbook.md)
• [error-translation.md](../../references/error-translation.md)
• [response-contract.md](../../references/response-contract.md)
• [presentation-guide.md](../../references/presentation-guide.md)
• [learn-more.md](../../references/learn-more.md)
• [data-api-doc.md](../../references/data-api-doc.md)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AveCloud
• Source: AveCloud/ave-cloud-skill
• License: MIT

Install and usage instructions live in the source repository linked above.