ave-data-rest

name	ave-data-rest
version	2.4.0
description	Query on-chain crypto data via the AVE Cloud Data REST API (https://cloud.ave.ai/). Use this skill whenever the user wants to: - Search for tokens by name, symbol, or contract address - Get token price, market cap, TVL, volume, or price change data - View kline/candlestick (OHLCV) chart data for a token or trading pair - Check top 100 token holders and their distribution - Browse recent swap transactions for a trading pair - View trending tokens on a specific chain - View ranked tokens by topic (hot, meme, gainer, loser, new, AI, DePIN, GameFi, etc.) - Run a contract security/risk detection report (honeypot, buy/sell tax, ownership) - Get wallet swap history, token PnL, and holdings - Get wallet overview and smart wallet discovery - Get public trading signals - Get liquidity transactions and transaction details for a pair - Get trading pair detail - Get Ondo-mapped kline data - Batch search token details by address-chain list - List supported chain identifiers - Get main/native tokens for a chain - Get tokens from a specific launchpad or platform (pump.fun, fourmeme, bonk, nadfun) DO NOT use this skill for: - Real-time streaming or WebSocket subscriptions → use ave-data-wss instead - Executing trades or swaps → use ave-trade-chain-wallet or ave-trade-proxy-wallet instead
license	MIT
metadata	{"openclaw":{"primaryEnv":"AVE_API_KEY","requires":{"env":["AVE_API_KEY","API_PLAN"],"bins":["python3"]}}}

ave-data-rest

Snapshot on-chain token data via the AVE Cloud Data REST API. For shared operating rules and response norms, see operator-playbook.md.

Setup

export AVE_API_KEY="your_api_key_here"
export API_PLAN="free"   # free | normal | pro

Get a free key at https://cloud.ave.ai/register.

Rate Limits

API_PLAN	Read TPS
free	1
normal	5
pro	20

Supported Chains

130+ chains, including bsc, eth, base, solana, tron, polygon, arbitrum, avalanche, sui, ton, aptos.

Operations

Token Discovery

Search tokens

Find tokens by keyword, symbol, or contract.

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

Search token details (batch)

Look up full details for up to 50 tokens by address-chain.

python scripts/ave_data_rest.py search-details --tokens <addr1>-<chain1> [<addr2>-<chain2> ...]

Platform tokens

Browse launchpad or topic feeds by platform tag.

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

Trending

Get trending tokens for a chain.

python scripts/ave_data_rest.py trending --chain <chain> [--page 0] [--page-size 20]

Rank topics

List available ranking topics.

python scripts/ave_data_rest.py rank-topics

Ranks

Get ranked tokens for a topic.

python scripts/ave_data_rest.py ranks --topic <topic>

Token Detail

Token detail

Get price, liquidity, volume, pairs, and token summary.

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

Token prices (batch)

Batch price lookup for up to 200 tokens.

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

Risk report

Run the contract security and honeypot report.

python scripts/ave_data_rest.py risk --address <token> --chain <chain>

Holders

Get token holders with sorting.

python scripts/ave_data_rest.py holders --address <token> --chain <chain> [--limit 100] [--sort-by balance] [--order desc]

Main tokens

Get the main or native tokens for a chain.

python scripts/ave_data_rest.py main-tokens --chain <chain>

Chains

List supported chain identifiers.

python scripts/ave_data_rest.py chains

Kline / Charts

Kline by token

Get OHLCV candles by token address.

python scripts/ave_data_rest.py kline-token --address <token> --chain <chain> [--interval 60] [--size 24]

Kline by pair

Get OHLCV candles by pair address.

python scripts/ave_data_rest.py kline-pair --address <pair> --chain <chain> [--interval 60] [--size 24]

Kline Ondo

Get Ondo-mapped kline data by pair address or ticker.

python scripts/ave_data_rest.py kline-ondo --pair <pair_address-chain or ticker> [--interval 60] [--size 24]

Transactions

Swap transactions

Get recent swap transactions for a pair.

python scripts/ave_data_rest.py txs --address <pair> --chain <chain>

Liquidity transactions

Get liquidity add/remove/create events for a pair.

python scripts/ave_data_rest.py liq-txs --address <pair> --chain <chain> [--type all] [--limit 100]

Transaction detail

Look up a specific transaction by hash.

python scripts/ave_data_rest.py tx-detail --chain <chain> --account <address> --tx-hash <hash>

Pair

Pair detail

Get trading pair information.

python scripts/ave_data_rest.py pair --address <pair> --chain <chain>

Wallet / Address

Wallet swap history

Get swap transactions for a wallet address.

python scripts/ave_data_rest.py address-txs --wallet <address> --chain <chain> [--token <token>]

Wallet token PnL

Get profit/loss for a wallet on a specific token.

python scripts/ave_data_rest.py address-pnl --wallet <address> --chain <chain> --token <token>

Wallet token holdings

Get paginated token holdings for a wallet.

python scripts/ave_data_rest.py wallet-tokens --wallet <address> --chain <chain> [--sort last_txn_time] [--hide-sold] [--blue-chips]

Wallet overview

Get wallet summary and stats.

python scripts/ave_data_rest.py wallet-info --wallet <address> --chain <chain>

Smart wallet discovery

List smart wallets with profit-tier filters.

python scripts/ave_data_rest.py smart-wallets --chain <chain> [--keyword <keyword>]

Signals

Public trading signals

Get public trading signal feed.

python scripts/ave_data_rest.py signals [--chain solana] [--page-size 10] [--page-no 1]

Workflow Example

Run search -> token -> risk -> holders before discussing a new token.

python scripts/ave_data_rest.py search --keyword "DOGE" --chain bsc --limit 5
python scripts/ave_data_rest.py token --address 0xbA2aE424d960c26247Dd6c32edC70B295c744C43 --chain bsc
python scripts/ave_data_rest.py risk --address 0xbA2aE424d960c26247Dd6c32edC70B295c744C43 --chain bsc
python scripts/ave_data_rest.py holders --address 0xbA2aE424d960c26247Dd6c32edC70B295c744C43 --chain bsc

Reference

Use shared references for operator rules, response shape, presentation, and fuller API details when the task needs more than the CLI surface here.

• operator-playbook.md
• error-translation.md
• response-contract.md
• presentation-guide.md
• learn-more.md
• data-api-doc.md