链上数据 API

有哪些数据可以访问

持续采集、实时更新，覆盖 Solana / BSC。点击卡片直达对应接口文档。

快速开始

1. 获取 API Key

联系管理员开通，获得形如 gmgn_xxxxxxxx 的专属 Key。Key 等同于账号凭证，请勿泄露。

2. 接口地址

3. 发起第一个请求

4. 返回结构

所有成功请求返回 HTTP 200，结构统一：

{
  "code": 0,               // 0 表示成功
  "message": "success",
  "data": {
    "chain": "sol",        // 请求的链（无链参数的接口为 null）
    "period": "1h",        // 请求的周期（部分接口有）
    "updated_at": 1793366340, // 这批数据的更新时间（Unix 秒）
    "count": 20,           // 本次返回条数
    "items": [ ... ]       // 数据列表
  }
}

通用约定

字段约定

数据更新频率

比数据更新还频繁的请求只会拿到相同结果。用返回里的 updated_at 判断数据是否有变化。

支持的链

接口文档

以下接口都需要在请求头携带 X-API-Key。点击展开查看参数、返回字段与示例。

错误处理

请求失败时返回非 200 状态码，响应体格式为：

{ "detail": "invalid api key" }

参数校验失败（422）时，detail 是一个数组，指出具体哪个参数有问题。

接入建议

• Key 只放在后端。由你的服务端调用接口，再把结果给前端，避免 Key 被他人抓包盗用。
• 新币用增量拉取。记录上次拿到的最大 created_at，下次带上 since=该值，只取新增代币。
• 按 updated_at 去重。榜单类接口如果 updated_at 没变，说明数据还没刷新，可直接跳过处理。
• 设置超时。建议客户端超时 10 秒，失败按上表重试。
• 做好判空。新上的代币很多字段（市值、持仓、Logo）可能是 null 或 0。
• 按需取量。用 limit 只取需要的条数，响应更快。

常见问题