# Ave Data Wss

> |

- **Type:** Skill
- **Install:** `agentstack add skill-avecloud-ave-cloud-skill-data-wss`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AveCloud](https://agentstack.voostack.com/s/avecloud)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AveCloud](https://github.com/AveCloud)
- **Source:** https://github.com/AveCloud/ave-cloud-skill/tree/main/skills/data-wss

## Install

```sh
agentstack add skill-avecloud-ave-cloud-skill-data-wss
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
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.

```bash
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.

```bash
python scripts/ave_data_wss.py watch-tx --address  --chain  [--topic tx]
```

### Watch kline

Stream live kline updates for a pair.

```bash
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.

```bash
python scripts/ave_data_wss.py watch-price --tokens - [- ...]
```

### Server daemon

Start or stop the reusable Docker-backed connection.

```bash
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.

```bash
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](https://github.com/AveCloud)
- **Source:** [AveCloud/ave-cloud-skill](https://github.com/AveCloud/ave-cloud-skill)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-avecloud-ave-cloud-skill-data-wss
- Seller: https://agentstack.voostack.com/s/avecloud
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.