API文档 - GMGN官网 | 开发者接口文档

概述

GMGN API 基于 RESTful 架构设计，所有接口均使用 HTTPS 协议。返回数据格式为 JSON，字符编码为 UTF-8。基础 URL 为：

                        // API 基础地址

                        https://api.gmgn-b.com.cn/v1

所有 API 请求需要在 Header 中携带认证信息。支持以下公链：Ethereum、Solana、Base、BSC、Arbitrum、Polygon、Optimism、Avalanche 等 15+ 条主流公链。

认证方式

使用 API Key 进行身份认证。在请求 Header 中添加以下字段：

                        X-API-Key: your_api_key_here

                        Content-Type: application/json

API Key 可在 GMGN 官网的开发者中心申请。免费版每分钟最多 60 次请求，专业版每分钟最多 1000 次请求。

代币数据 API

获取代币的实时价格、持仓分布、交易数据等详细信息。

获取代币详情

GET /token/{chain}/{address}

参数	类型	必填	说明
`chain`	string	必填	链标识，如 eth、sol、base、bsc
`address`	string	必填	代币合约地址

请求示例：

                        // 获取 Solana 上某代币的详情

                        curl -X GET "https://api.gmgn-b.com.cn/v1/token/sol/So11111111111111111111111111111111111111112" \

                          -H "X-API-Key: your_api_key"

响应示例：

                        {

                          "code": 0,

                          "data": {

                            "name": "Wrapped SOL",

                            "symbol": "SOL",

                            "price": 178.52,

                            "price_change_24h": 3.25,

                            "volume_24h": 1250000000,

                            "liquidity": 850000000,

                            "holders": 45230,

                            "market_cap": 78500000000,

                            "created_at": "2024-01-15T08:30:00Z"

                          }

                        }

获取代币列表（新币）

GET /tokens/new?chain={chain}&limit={limit}

参数	类型	必填	说明
`chain`	string	必填	链标识
`limit`	integer	可选	返回数量，默认 20，最大 100
`sort`	string	可选	排序方式：created_at、volume、liquidity

聪明钱追踪 API

查询聪明钱地址的持仓、交易记录和收益数据。

获取聪明钱列表

GET /smart-money/list?chain={chain}&tag={tag}

参数	类型	必填	说明
`chain`	string	必填	链标识
`tag`	string	可选	标签筛选：sniper、whale、insider、defi
`limit`	integer	可选	返回数量，默认 20

响应示例：

                        {

                          "code": 0,

                          "data": [

                            {

                              "address": "0x1234...abcd",

                              "tags": ["whale", "sniper"],

                              "win_rate": 0.78,

                              "total_profit": 1250000,

                              "avg_hold_time": "2h 35m",

                              "tokens_traded": 342

                            }

                          ]

                        }

查询地址持仓

GET /wallet/{chain}/{address}/positions

安全检测 API

对代币合约进行安全扫描，检测蜜罐、貔貅盘、高税率等风险。

合约安全检测

GET /security/check/{chain}/{address}

响应示例：

                        {

                          "code": 0,

                          "data": {

                            "is_honeypot": false,

                            "buy_tax": 0.05,

                            "sell_tax": 0.05,

                            "is_mintable": false,

                            "has_blacklist": true,

                            "liquidity_locked": true,

                            "lock_duration": "365 days",

                            "ownership_renounced": true,

                            "risk_level": "low",

                            "risk_score": 15

                          }

                        }

交易 API

通过 API 执行代币买卖交易。需要钱包签名认证。

获取报价

POST /trade/quote

请求示例：

                        {

                          "chain": "eth",

                          "token_in": "0xC02aaA...WETH",

                          "token_out": "0x6982...PEPE",

                          "amount_in": "1000000000000000000",

                          "slippage": 0.5

                        }

提交交易

POST /trade/execute

提交已签名的交易数据到链上。需要先在客户端完成钱包签名。

速率限制

套餐	请求频率	每日配额	价格
免费版	60 次/分钟	10,000 次	免费
基础版	300 次/分钟	100,000 次	$49/月
专业版	1,000 次/分钟	1,000,000 次	$199/月
企业版	定制	无限	联系我们

错误码

错误码	说明	解决方案
`400`	请求参数错误	检查请求参数格式和必填项
`401`	认证失败	检查 API Key 是否正确
`403`	权限不足	确认当前套餐是否支持该接口
`404`	资源不存在	检查链标识和合约地址
`429`	请求过于频繁	降低请求频率或升级套餐
`500`	服务器内部错误	请稍后重试或联系技术支持