Alph-ai-agent 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
{chain} 支持：eth、bsc、base、xlayer、plasma、monad、kasplex、sol
返回该链上所有发币平台的 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