AVE Cloud Skill

The AVE Cloud API provides on-chain analytics across 130+ blockchains and 300+ DEXs. This skill runs Python scripts to call the API and returns results as clear summaries.

Setup

Two environment variables are required:

export AVE_API_KEY="your_api_key_here"
export API_PLAN="free"   # allowed: free, normal, pro

Get a free key at https://cloud.ave.ai/register. For higher limits, contact support on Telegram: @ave_ai_cloud.

Rate limiting is handled by a built-in file-based limiter by default — no packages needed beyond the Python standard library.

Docker (sandboxed, uses requests + requests-ratelimiter for in-process rate limiting):

# Build once
docker build -f scripts/Dockerfile.txt -t ave-cloud .

# Run a command (example: search)
docker run --rm \
  -e AVE_API_KEY="your_key" \
  -e API_PLAN=free \
  ave-cloud search --keyword WBNB --chain bsc

The Docker image sets AVE_USE_DOCKER=true automatically, enabling in-process rate limiting via requests-ratelimiter. No volume mount needed.

If you want to run locally with the same in-process rate limiter (requires pip install -r scripts/requirements.txt):

export AVE_USE_DOCKER=true
python scripts/ave_client.py <command> [options]

How to use this skill

1. Identify what the user wants from the list of operations below
2. Run the appropriate command using scripts/ave_client.py
3. Format the JSON response as a readable summary or table

The script is at scripts/ave_client.py relative to the skill root.

All commands output JSON to stdout. Errors are printed to stderr with a non-zero exit code.

Operations

Search tokens

Find tokens by symbol, name, or contract address.

python scripts/ave_client.py search --keyword <keyword> [--chain <chain>] [--limit 20]

Useful when the user gives a token name/symbol and you need to resolve it to a contract address.

Platform tokens

Tokens from a specific launchpad or platform (e.g. pump.fun, fourmeme, bonk, nadfun).

python scripts/ave_client.py platform-tokens --platform <platform>

Common platforms: hot, new, meme, pump_in_hot, pump_in_new, fourmeme_in_hot, bonk_in_hot, nadfun_in_hot Full list of ~90 values is enforced by the CLI (--help to list them).

Token detail

Full data for a specific token: price, market cap, TVL, volume, supply, holders, DEX pairs.

python scripts/ave_client.py token --address <contract_address> --chain <chain>

Token prices (batch)

Prices for up to 200 tokens at once.

python scripts/ave_client.py price --tokens <addr1>-<chain1> <addr2>-<chain2> ...

Kline / candlestick data

OHLCV price history. Use kline-token when you have a token address; use kline-pair when you have a pair address.

python scripts/ave_client.py kline-token --address <token> --chain <chain> \
  [--interval <minutes>] [--size <count>]