Alph.ai 行情模块 API

本模块包含 42 个行情相关 API，涵盖：

• 币种详情 (18个) ⭐ 新增：代币完整详情接口
• 实时行情 (5个)
• 热门币种 (10个)
• WS 实时推送 (3个)
• 收藏功能 (3个)
• 扫链数据 (7个)
• Gas 费查询 (1个)
• 链信息 (1个)

⭐ 推荐接口：代币完整详情

当用户查询代币详情时，优先推荐使用：

GET /smart-web-gateway/token/token-detail

为什么推荐这个接口？

• ✅ 一站式查询：一次调用获取所有信息，无需多次请求
• ✅ 包含市值：直接返回市值数据（marketCap）
• ✅ 信息最全：价格、市值、供应量、持有者、流动性、安全信息、社交媒体等
• ✅ 单位明确：同时提供 BNB 和 USDT 计价

请求示例：

GET https://b.alph.ai/smart-web-gateway/token/token-detail?chain=bsc&token=0x924fa68a0fc644485b8df8abfa0a41c2e7744444
Header: Cookie: dex_cookie=<your_cookie>

包含的关键数据：

• 💰 价格（BNB 和 USDT）、市值
• 📊 总供应量、持有者数量
• 💧 流动性信息（池地址、流动性值、交易平台）
• 🔒 安全信息（开源、锁定、蜜罐、税率）
• 📱 社交媒体（Twitter、Telegram、Website、KOL提及）
• 🤖 AI 生成的代币描述和叙述

使用方式

1. 查询 API

查找币种详情接口
查询实时行情的 API
我想获取热门币种

2. 查看 API 详情

显示获取币价接口的详细信息
这个行情接口返回什么数据？

3. 生成调用代码

生成调用行情接口的 Python 代码
用 TypeScript 调用 WebSocket 推送

WebSocket 实时推送

行情数据支持通过 WebSocket 实时推送。连接前需要先获取 listenKey。

连接流程

1. POST https://b.alph.ai/smart-web-gateway/ws/listenkey
   Header: Cookie: dex_cookie=<value>
   Body: {}
   → 获取 listenKey（1小时过期，需自动续期）

2. 连接 wss://ws.alph.ai/stream/ws?listenKey=<listen_key>

3. 发送订阅消息获取行情推送

完整的认证和连接说明见 /alphai 主导航的 auth-guide.md

工作流程

当你询问行情、价格、币种相关问题时，我会：

1. 识别查询类型：
   • 📊 代币详情查询（合约地址、代币名称） → 优先推荐 /token/token-detail 接口
   • 💰 实时价格查询 → 使用 /ticker/currentPrice 或 /ticker/24h 接口
   • 🔥 热门币种列表 → 使用 /sherlock/popular_token/tokenPage 接口
   • 📈 K线数据 → 使用 GET /kline/new/history?chain=&token=&type= 接口（query 传参，非路径参数）
2. 从 apis.json 中搜索相关 API
3. 展示 API 的路径、方法、参数、响应格式
4. 根据需要生成调用代码示例
5. 提供 WebSocket 连接示例（如果需要），包含 listenKey 获取和自动续期
6. 提供使用建议和注意事项

💡 价格单位说明

重要：Alph.ai 的价格数据使用链原生代币作为计价单位：

• BSC 链：价格以 BNB 计价
• 以太坊链：价格以 ETH 计价
• Solana 链：价格以 SOL 计价

但 token-detail 接口同时提供：

• tokenPriceSol: 链原生代币计价（字段名是 Sol 但实际是链原生币）
• tokenPriceUsdt: USDT 计价（推荐使用，直观）
• marketCap: 市值（USD）

扫链数据（新币发现）

扫链接口用于发现各链上最新发射的代币，支持丰富的筛选条件。

接口列表

方法	路径	功能
GET	/snipe/platform/{chain}	获取可用平台列表（platform ID、DEX、标签）
POST	/snipe/list/new/{chain}	新币列表（最新发射的代币）
POST	/snipe/list/aimost/{chain}	AI 推荐列表（AI 筛选的热门新币）
POST	/snipe/list/graduated/{chain}	已毕业列表（从 bonding curve 进入 DEX）
POST	/snipe/list/hideToken	隐藏代币（从列表中隐藏指定代币）
GET	/snipe/homepage	代币主页信息（社区、推特、开发者）

snipe/list/all/{chain} 已废弃，请使用 aimost 替代。

重要：platform 为必传参数

调用 new、aimost、graduated 接口时，必须传 platform 参数，否则返回空数据。

platform 是平台 ID 的逗号分隔字符串，通过 GET /snipe/platform/{chain} 获取：

GET https://b.alph.ai/smart-web-gateway/snipe/platform/bsc

BSC 链：platform 传平台 ID 组合，如 "3,13"

id	平台名
0	All（全部）
3	Fourmeme
9	USD1
13	Flap
19	X Mode
28	Fourmeme Agent
10000	Others

SOL 链：platform 传 "All"

不同链的 platform 取值不同：BSC 用数字 ID 组合（如 "3,13"），SOL 用 "All"。调用前请先查询对应链的平台列表。

请求示例：查询 BSC 最新代币

POST https://b.alph.ai/smart-web-gateway/snipe/list/new/bsc
Header: Cookie: dex_cookie=<value>
Content-Type: application/json

{
    "language": "zh_CN",
    "platform": "3,13"
}

常用筛选参数

参数	类型	说明
platform	string	必传。平台 ID 逗号分隔，如 "3,13"
language	string	语言，如 "zh_CN"
limit	integer	返回数量
minAge / maxAge	integer	存活时间范围（分钟）
minMarketCap / maxMarketCap	number	市值范围（USD）
minLiquidityUsdt / maxLiquidityUsdt	number	流动性范围（USDT）
minHoldings / maxHoldings	number	持有人数范围
minTradeNum / maxTradeNum	number	交易笔数范围
minKolCalls / maxKolCalls	number	KOL 提及次数范围
label	array	标签过滤，如 ["MEME"]
hasTwitter	boolean	是否有 Twitter
hasWebsite	boolean	是否有官网
hasTelegram	boolean	是否有 Telegram
sort / sortField / asc	string	排序字段和方向
bondingCurve	integer	bonding curve 状态（1=在内盘）

返回数据字段

每个代币包含以下信息：

字段	说明
token	合约地址
tokenFullName / code	代币全名 / 符号
poolTime	上池时间（毫秒时间戳）
age	存活时间（分钟）
platform / poolName	发射平台 ID / 名称
marketCap	市值（USD）
price	当前价格
chg	涨跌幅
liquidityUsdt / liquidityMain	流动性（USDT / 链原生币）
holdings	持有人数
tradeNum / tradeAmount	交易笔数 / 交易额
top10	前10持有者占比
devProportion	开发者持有比例
kolCalls / fansNums / viewNums	KOL 提及 / 粉丝数 / 浏览数
security	安全信息
social	社交媒体（twitter/website/telegram）
bondingCurve	bonding curve 状态（1=内盘）
supply	总发行量
smartHolding	聪明钱包持仓数
sniper / bundler / insiders	狙击手 / 捆绑者 / 内部人比例

典型场景

查询过去1小时 BSC 新发的 meme 代币：

POST /snipe/list/new/bsc
{
    "platform": "3,13",
    "maxAge": 60,
    "label": ["MEME"],
    "language": "zh_CN"
}

查询有 KOL 提及、流动性 > $1000 的 Solana 新币：

POST /snipe/list/new/sol
{
    "platform": "1,2",
    "minKolCalls": 1,
    "minLiquidityUsdt": 1000,
    "language": "zh_CN"
}

---

API 数据来源

按功能分类存储在 apis/ 目录，按需查阅：

功能	文件	包含
币种详情	apis/token-detail.json	CoinDetailController (11个)
热门币种	apis/popular.json	热门、美股、PopularPage (11个)
实时行情	apis/ticker.json	行情接口 (5个)
WS推送	apis/websocket.json	WebSocket 推送 (3个)
扫链数据	apis/scan.json	扫链三栏 (7个)
其他	apis/misc.json	收藏、Gas费、链信息 (5个)

查找 API 时请直接读取对应的分类文件，不要读取 apis.json 全量文件。

---

参数占位符: $ARGUMENTS