ave_api_notes.md

Ave API 笔记

认证方式

所有API请求需要添加Header：

X-API-KEY: <your-api-key>

Base URL

• https://prod.ave-api.com
• https://data.ave-api.xyz

Token Price API

Endpoint: POST /v2/tokens/price

功能: 获取代币价格信息（最多200个代币）

请求参数:

{
  "token_ids": ["<token_address>:<chain>"],
  "tvl_min": 1000,  // 可选，最小TVL
  "tx_24h_volume_min": 0  // 可选，最小24h交易量
}

响应字段:

• current_price_usd: 当前价格（USD）
• price_change_1d: 24小时价格变化
• price_change_24h: 24小时价格变化百分比
• tvl: 总锁仓价值
• fdv: 完全稀释市值
• market_cap: 市值
• tx_volume_u_24h: 24小时交易量（USD）
• token_id: 代币ID
• updated_at: 更新时间戳

Token Detail API

Endpoint: POST /v2/tokens/search

功能: 批量获取代币详细信息（最多50个）

请求参数:

{
  "token_ids": ["<token_address>:<chain>"]
}

响应字段:

• current_price_usd: 当前价格
• price_change_24h: 24小时涨跌幅
• tvl: 总锁仓价值
• fdv: 完全稀释市值
• market_cap: 市值
• tx_volume_u_24h: 24小时交易量
• token_id: 代币ID
• updated_at: 更新时间

需要的数据映射

用户示例中的字段 → Ave API字段：

• 💰 当前价格 → current_price_usd
• 👨 持仓人数 → 需要其他API或数据源
• 🚀 市值 → market_cap
• 🔥 当前涨幅 → price_change_24h
• 📈 5m/1h → 需要Kline API或其他数据源
• 🌊 24小时交易量 → tx_volume_u_24h
• 📒 叙事 → 需要其他数据源或手动标注

注意事项

1. Ave API主要提供价格和交易量数据
2. 持仓人数、5m/1h涨跌幅、叙事等需要其他数据源
3. token_id格式：<address>:<chain>，例如 6pbxgHy7AeE6TZkSmFskod44wqoP15icUSq1ziG1PN-so:solana