Alph.ai 社媒推特(X) 模块 API

本模块包含 11 个 HTTP API + WebSocket 实时推送，支持完整的推特监控链路： 关注 KOL → 配置监控项 → 拉取历史推文 / WebSocket 实时接收 → 翻译 → 分析 → 推文 meme 代币搜索

API 列表

推文数据格式（重要）

推文类型

通过 config 接口可配置监控以下类型：

推文数据结构

monitorList / WebSocket 返回的每条推文数据：

{
    "type": "replied_to",
    "id": "2026538218787893548",
    "created_at": "2026-02-25T06:02:17.000Z",
    "text": "@frankyluan 基座模型与工程化还是两回事...",
    "tweets": {
        "text": "True",
        "id": "2026558347798004185",
        "media": []
    },
    "referenced": {
        "text": "If we based our sentencing on recidivism data...",
        "id": "2026365444282851690",
        "media": []
    }
}

字段说明：

不同推文类型的数据示例

推文类型说明：

• send：tweets.text 为原创内容，无 referenced
• replied_to / quoted：tweets.text 为本人内容，referenced.text 为被回复/引用的原文
• retweeted：text 为空，内容在 referenced.text

数据获取方式

方式 1：HTTP 拉取历史推文

通过 monitorList 接口拉取已关注 KOL 的历史推文列表：

POST https://b.alph.ai/smart-web-gateway/tracker/x/monitorList
Header: Cookie: dex_cookie=<value>
Body: { "pageNum": 1, "pageSize": 20 }

通过 myList 可查看已关注的 KOL 列表（支持按用户名筛选和排序）：

POST https://b.alph.ai/smart-web-gateway/tracker/x/myList
Header: Cookie: dex_cookie=<value>
Body: { "username": "", "pageNum": 1, "pageSize": 20, "sort": "x_follow", "asc": "desc" }

注意：myList 返回的是 KOL 账户列表（id/name/username/followed），不是推文内容。要获取推文内容请用 monitorList。

方式 2：WebSocket 实时推送

1. POST /smart-web-gateway/ws/listenkey → 获取 listenKey（1小时过期，需自动续期）
2. 连接 wss://ws.alph.ai/stream/ws?listenKey=<listen_key>
3. 发送订阅：
   {
     "id": "0c1bfd5cb47fb8051e62d333b99916e72c695203fa9d94b171eed267486efb0c",
     "event": "SUBSCRIBE",
     "params": [{"type": "user_tracker_x"}]
   }
4. 实时接收已关注 KOL 的推文推送（数据格式同上）

完整的 dex_cookie 获取、listenKey 认证、自动续期说明见 auth-guide.md 完整的代码示例（Python/JavaScript）见 examples.md

典型使用场景

场景 1：监控 KOL 发帖并通知

flow: follow(KOL) → config(send/retweeted/replied_to/quoted)
      → WebSocket 订阅 user_tracker_x → 收到推文 → 推送到 Telegram

场景 2：抓取某 KOL 最新 N 条推文并分析

flow: follow(KOL) → myList(username=xx, pageSize=20)
      → 拿到推文 text → Claude 分析总结

场景 3：监控推文中的 CA（合约地址）并报警

flow: WebSocket 收到推文 → 从 text 和 referenced.text 中提取 CA
      → 查询行情/流动性 → 推送报警

场景 4：批量分析 KOL 推文内容

flow: 批量 follow KOL 列表 → 逐个 myList 拉取推文
      → Claude 分析推文内容 → 打分/分类

场景 5：根据推文链接查找 meme 代币

flow: 用户提供推文链接 → twitter-search 提取关联代币
      → 按 poolLiquidityUsdt 筛选有流动性的代币 → 查询行情详情

场景 6：查询 KOL 详情并拉取最新推文

flow: x/detail(user=KOL用户名) → 获取用户 ID 和粉丝数
      → x/tweets(keyword=用户ID, nums=20) → 获取最新推文 → 分析内容

场景 7：按关键词搜索推文舆情

flow: x/search(keyword="BTC", nums=20) → 获取相关推文
      → 分析推文情绪和互动数据 → 生成舆情报告

配置接口详情

follow - 关注/取消关注

POST /smart-web-gateway/tracker/x/follow
{
    "username": "cz_binance",
    "operationType": 1
}

• operationType: 1=关注, 0=取消关注

config - 监控配置

POST /smart-web-gateway/tracker/x/config
{
    "send": true,
    "retweeted": true,
    "replied_to": true,
    "quoted": true,
    "follow": false,
    "profile": false,
    "icon": false,
    "nick": false,
    "banner": false,
    "account": false
}

transTexts - 翻译

POST /smart-web-gateway/tracker/x/transTexts
{
    "from": "en",
    "to": "cn",
    "text": "GM! BTC to the moon!"
}
// 返回: { "data": { "result": "早上好！BTC 冲！" } }

twitter-search - 推文 meme 代币搜索

根据推文 URL 提取该推文下关联的 meme 代币合约地址，返回链名、代币地址和池子流动性。

GET /smart-web-gateway/token/twitter-search?twitter=https://x.com/tige_seal/status/2028404440110350738

返回示例：

{
    "code": "200",
    "msg": "suc",
    "data": [
        {
            "chain": "sol",
            "tokenAddress": "HqCftALtKGdZAQnva2u7hZDsd5namLZjFLtAGVmzqTU3",
            "poolLiquidityUsdt": 16377.57
        },
        {
            "chain": "bsc",
            "tokenAddress": "0xa08947e1b2bcd9dc48fafb30e740be3094377777",
            "poolLiquidityUsdt": 17242.27
        }
    ]
}

x/detail - X 用户详情

根据用户名获取 X 账户详细信息。

POST /smart-web-gateway/x/detail
{
    "user": "cz_binance"
}

返回示例：

{
    "code": 200,
    "data": {
        "twitterDet": {
            "data": {
                "id": "1885979923195797504",
                "name": "Joan",
                "username": "Joan55683254681",
                "description": "ka ka wa",
                "created_at": "2025-02-02T09:14:16Z",
                "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo_normal.jpg",
                "profile_banner_url": "https://pbs.twimg.com/profile_banners/...",
                "public_metrics": {
                    "followers_count": 2,
                    "following_count": 14,
                    "like_count": 0,
                    "listed_count": 1,
                    "tweet_count": 74
                },
                "verified": false,
                "verified_type": "none"
            }
        }
    }
}

x/search - 推文关键词搜索

按关键词搜索推文，返回推文内容、互动数据和作者信息。

POST /smart-web-gateway/x/search
{
    "keyword": "BTC",
    "nums": 10
}

返回示例：

{
    "code": 200,
    "data": {
        "twitterDet": {
            "data": [
                {
                    "id": "2028734723581764056",
                    "author_id": "1508528078854795271",
                    "text": "RT @Dexerto: A teacher with 900k+ YouTube...",
                    "public_metrics": {
                        "bookmark_count": 0,
                        "impression_count": 1,
                        "like_count": 0,
                        "quote_count": 0,
                        "reply_count": 0,
                        "retweet_count": 830
                    }
                }
            ],
            "includes": {
                "users": [
                    {
                        "id": "1508528078854795271",
                        "name": "Crazy Ass Moments in Italian Politics",
                        "username": "CrazyItalianPol",
                        "public_metrics": { "followers_count": 120029, "..." : "..." }
                    }
                ]
            },
            "meta": {
                "result_count": 10,
                "next_token": "b26v89c19zqg8o3j..."
            }
        }
    }
}

x/tweets - 获取用户推文列表

根据用户 ID 获取该用户的最新推文列表。

注意：keyword 参数传的是用户 ID（数字），不是用户名。可先通过 x/detail 获取用户 ID。

POST /smart-web-gateway/x/tweets
{
    "keyword": "1852674305517342720",
    "nums": 10
}

返回示例：

{
    "code": 200,
    "data": {
        "twitterDet": {
            "data": [
                {
                    "id": "2028747575239864471",
                    "author_id": "1852674305517342720",
                    "created_at": "2026-03-03T08:21:28.000Z",
                    "text": "@markets_wizard one entity owns 3.71% of supply...",
                    "entities": {
                        "mentions": [{ "username": "markets_wizard", "..." : "..." }],
                        "annotations": [],
                        "cashtags": []
                    },
                    "public_metrics": {
                        "impression_count": 27,
                        "like_count": 0,
                        "retweet_count": 0,
                        "reply_count": 1,
                        "quote_count": 0,
                        "bookmark_count": 0
                    }
                }
            ],
            "includes": {
                "users": [
                    {
                        "id": "1852674305517342720",
                        "name": "aixbt",
                        "username": "aixbt_agent",
                        "public_metrics": { "followers_count": 472589, "..." : "..." }
                    }
                ]
            },
            "meta": {
                "result_count": 10,
                "next_token": "7140dibdnow9c7btw..."
            }
        }
    }
}

工作流程

当你询问推特(X)/社媒相关问题时，我会：

1. 理解需求（监控/拉取/分析/翻译）
2. 推荐合适的接口和获取方式（HTTP 拉取 or WebSocket 实时推送）
3. 说明推文数据格式，包括不同类型（发推/转发/回复/引用）的区别
4. 生成完整的调用代码（含 dex_cookie 认证和 listenKey 续期）
5. 提供监控策略和最佳实践建议

API 数据来源

完整的 API 定义存储在同目录下的 apis.json 文件中。

参数占位符: $ARGUMENTS