GMGN.ai Smart Money Wallets API

Get gmgn.ai smart-money wallet rankings — top crypto traders on Solana, Ethereum, Base & Tron with realized profit, PnL, win rate, and Twitter handles as JSON.

原始信息汇总

数据集概述：GMGN.ai Smart Money Wallets API

1. 核心功能

该API从 gmgn.ai 实时获取 Solana、Ethereum、Base、Tron 四条链上表现最佳的“聪明钱”加密货币交易者钱包排名数据，并以结构化JSON格式返回。单次调用返回约 100个 盈利能力最强的钱包及其详细指标。

2. 数据亮点

• 覆盖范围：支持 Solana (sol)、Ethereum (eth)、Base (base)、Tron (tron) 四条区块链。
• 数据时效：每次调用实时从 gmgn.ai 获取最新排名。
• 钱包标签：返回 gmgn.ai 赋予的钱包标签，如 kol（意见领袖）、whale（鲸鱼）、smart_money（聪明钱）。
• 社交关联：提供钱包关联的 Twitter 用户名和头像 URL。
• 响应速度：约 1-2秒 内返回结构化JSON数据。

3. 主要数据字段

每个钱包对象包含以下关键字段：

字段	类型	说明
walletAddress	string	链上钱包地址
chain	string	所属链（sol/eth/base/tron）
period	string	排名窗口（7d/30d）
buy / sell	number	该窗口内的买入/卖出交易次数
realizedProfit1d/7d/30d	string	过去 1天/7天/30天 的已实现利润（美元，高精度字符串）
pnl1d/7d/30d	string	过去 1天/7天/30天 的盈亏比率（高精度字符串）
winrate	number	胜率（0-100百分比）
twitterUsername	string	关联的 Twitter/X 用户名（若无则为 null）
avatar	string	用户头像图片URL（若已知）
tags	array	gmgn.ai 赋予的标签，如 kol, smart_money, whale

4. 端点与参数

• 请求方法：GET /
• 请求参数：
  • chain（可选，默认 sol）：指定区块链，可选值 sol、eth、base、tron。
  • period（可选，默认 7d）：排名时间窗口，可选值 7d 或 30d。

5. 典型应用场景

• 跟单交易机器人：跟踪排名最高的钱包，镜像其交易行为。
• 聪明钱/链上阿尔法追踪：识别近期实现利润最多的钱包地址。
• 钱包分析仪表盘：构建排行榜、筛选器和盈亏表。
• 信号增强：将钱包标签和 Twitter 句柄补充到链上数据分析中。

6. 错误处理

请求失败时会返回包含 error 和 message 字段的JSON响应。主要错误包括：

• 400 Bad Request：参数（如 chain 或 period）值无效。
• 502 Scrape Failed：向 gmgn.ai 的上游请求失败，可重试。

7. 注意事项

• 利润和盈亏比字段以 高精度字符串 形式返回，需使用十进制库解析以避免浮点数舍入误差。
• 这是一个 非官方 API，与 gmgn.ai 无关联或背书，仅用于研究和分析目的。