| 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"
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.
