# Ave Data Rest

> |

- **Type:** Skill
- **Install:** `agentstack add skill-avecloud-ave-cloud-skill-data-rest`
- **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-rest

## Install

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

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

## About

# 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](../../references/operator-playbook.md).

## Setup
```bash
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.
```bash
python scripts/ave_data_rest.py search --keyword  [--chain ] [--limit 20]
```

#### Search token details (batch)
Look up full details for up to 50 tokens by address-chain.
```bash
python scripts/ave_data_rest.py search-details --tokens - [- ...]
```

#### Platform tokens
Browse launchpad or topic feeds by platform tag.
```bash
python scripts/ave_data_rest.py platform-tokens --platform 
```

#### Trending
Get trending tokens for a chain.
```bash
python scripts/ave_data_rest.py trending --chain  [--page 0] [--page-size 20]
```

#### Rank topics
List available ranking topics.
```bash
python scripts/ave_data_rest.py rank-topics
```

#### Ranks
Get ranked tokens for a topic.
```bash
python scripts/ave_data_rest.py ranks --topic 
```

### Token Detail

#### Token detail
Get price, liquidity, volume, pairs, and token summary.
```bash
python scripts/ave_data_rest.py token --address  --chain 
```

#### Token prices (batch)
Batch price lookup for up to 200 tokens.
```bash
python scripts/ave_data_rest.py price --tokens - - ...
```

#### Risk report
Run the contract security and honeypot report.
```bash
python scripts/ave_data_rest.py risk --address  --chain 
```

#### Holders
Get token holders with sorting.
```bash
python scripts/ave_data_rest.py holders --address  --chain  [--limit 100] [--sort-by balance] [--order desc]
```

#### Main tokens
Get the main or native tokens for a chain.
```bash
python scripts/ave_data_rest.py main-tokens --chain 
```

#### Chains
List supported chain identifiers.
```bash
python scripts/ave_data_rest.py chains
```

### Kline / Charts

#### Kline by token
Get OHLCV candles by token address.
```bash
python scripts/ave_data_rest.py kline-token --address  --chain  [--interval 60] [--size 24]
```

#### Kline by pair
Get OHLCV candles by pair address.
```bash
python scripts/ave_data_rest.py kline-pair --address  --chain  [--interval 60] [--size 24]
```

#### Kline Ondo
Get Ondo-mapped kline data by pair address or ticker.
```bash
python scripts/ave_data_rest.py kline-ondo --pair  [--interval 60] [--size 24]
```

### Transactions

#### Swap transactions
Get recent swap transactions for a pair.
```bash
python scripts/ave_data_rest.py txs --address  --chain 
```

#### Liquidity transactions
Get liquidity add/remove/create events for a pair.
```bash
python scripts/ave_data_rest.py liq-txs --address  --chain  [--type all] [--limit 100]
```

#### Transaction detail
Look up a specific transaction by hash.
```bash
python scripts/ave_data_rest.py tx-detail --chain  --account  --tx-hash 
```

### Pair

#### Pair detail
Get trading pair information.
```bash
python scripts/ave_data_rest.py pair --address  --chain 
```

### Wallet / Address

#### Wallet swap history
Get swap transactions for a wallet address.
```bash
python scripts/ave_data_rest.py address-txs --wallet  --chain  [--token ]
```

#### Wallet token PnL
Get profit/loss for a wallet on a specific token.
```bash
python scripts/ave_data_rest.py address-pnl --wallet  --chain  --token 
```

#### Wallet token holdings
Get paginated token holdings for a wallet.
```bash
python scripts/ave_data_rest.py wallet-tokens --wallet  --chain  [--sort last_txn_time] [--hide-sold] [--blue-chips]
```

#### Wallet overview
Get wallet summary and stats.
```bash
python scripts/ave_data_rest.py wallet-info --wallet  --chain 
```

#### Smart wallet discovery
List smart wallets with profit-tier filters.
```bash
python scripts/ave_data_rest.py smart-wallets --chain  [--keyword ]
```

### Signals

#### Public trading signals
Get public trading signal feed.
```bash
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.
```bash
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](../../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:** no
- **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-rest
- 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%.
