Alph.ai 公共模块 API
本模块包含 8 个公共功能 API,涵盖:
- 黑名单查询 (1个)
- 发币平台信息 (1个)
- SEO 数据 (3个)
- PnL 分享 (3个)
核心接口速查
1. 代币黑名单查询
GET /smart-web-gateway/data-center/blacklist/data
?chain=bsc&token=0xabc...,0xdef...
chain:链名(bsc、sol、eth 等)token:合约地址,逗号分隔,支持批量查询
返回字段:chain、tokenAddress、holderNum(持有人数)、liquidity(流动性)、marketcap(市值)
2. 发币平台信息
GET /smart-web-gateway/common/platform/{chain}?language=zh_CN
返回该链上所有发币平台的 id、code(平台名)、icon、color。
这是 alphai-market 扫链接口中 platform 参数的数据来源。
PnL 分享卡片
用于生成代币盈亏分享卡片(用于社交媒体分享)。
查询代币分享详情
GET /smart-web-gateway/share/token-pnl
?walletAddress=<钱包地址>&chain=sol&token=<代币名>&language=zh_CN
返回字段:
| 字段 | 说明 |
|---|---|
tokenCode | 代币名 |
iconUrl | 代币图标 |
allProfit | 总盈亏(USD) |
totalProfitPercent | 总盈亏占比 |
holdingBalance | 当前持仓价值 |
totalBuy / totalSell | 总买入 / 总卖出 |
twitterName | 关联 X 账号名称 |
backgroundImage | 默认背景图列表 |
查询钱包分享详情
GET /smart-web-gateway/share/wallet-pnl
?walletAddress=<钱包地址>&chain=sol&language=en_US
返回字段:realizedPnl7d(7D已实现利润)、realizedPnl30d(30D已实现利润)、unrealizedPnl(未实现利润)、totalPnl(总利润)、tradeBuyNum7d/tradeSellNum7d(7D交易笔数)
查询是否可分享
GET /smart-web-gateway/share/display
?walletAddress=<钱包地址>&chain=sol&token=<代币名>
返回 data: true/false,判断该钱包/代币组合是否有分享数据。
SEO 数据接口
| 方法 | 路径 | 功能 |
|---|---|---|
| GET | /smart-web-gateway/token/seo/list | 分页获取代币 SEO 列表(token 地址列表) |
| GET | /seo-web-gateway/token/token-seo | 代币 SSR 数据(价格、市值、涨跌等) |
| GET | /seo-web-gateway/token/token-seo-sitemap | Sitemap 数据(链 + 合约地址) |
token-seo 接口参数:chain、token(合约地址)
工作流程
当你询问公共功能相关问题时,我会:
- 从
apis.json中搜索相关 API - 展示 API 的路径、方法、参数、响应格式
- 根据需要生成调用代码示例
- 提供使用建议和注意事项
API 数据来源
完整的 API 定义存储在同目录下的 apis.json 文件中。
参数占位符: $ARGUMENTS