Snowball CLI — 雪球数据命令行工具

封装雪球 (xueqiu.com) API，所有输出为 JSON 格式，专为 AI Agent 和脚本设计。

覆盖范围：A 股（沪深）、港股、美股（经雪球）、公募基金（经蛋卷）。

重要：先用再登录

不要一上来就让用户登录。 以下命令无需登录即可使用：

snowball quote SH600519              # 实时行情
snowball market                      # 大盘指数
snowball fund 110011                 # 基金详情
snowball fund 110011 --nav           # 基金净值
snowball fund 110011 --growth        # 基金收益

只有当命令返回「Not logged in」错误时，再引导用户登录。先 snowball status 检查是否已有 token。

安装

如果 snowball 命令不存在，提示用户运行：

npm install -g snowball-cli

登录（仅在需要时）

大部分命令需要雪球登录态。上面列出的 quote、market、fund 无需登录。

遇到「Not logged in」错误时，提示用户自行完成登录。不要代替用户执行认证命令。 告知用户以下方式：

• snowball login — 用雪球 App 扫码登录（需要 Chrome/Chromium）
• snowball export / snowball import <base64> — 从已登录的机器导入 token

可以用 snowball status 检查当前 token 状态。

代码格式

格式	市场	示例
SHxxxxxx	上交所	SH600519（贵州茅台）
SZxxxxxx	深交所	SZ000858（五粮液）、SZ300750（宁德时代）
SH000xxx	上证指数	SH000001（上证综指）
SZ399xxx	深证指数	SZ399001（深证成指）
xxxxx	港股	01810（小米）
XXXX	美股	AAPL（苹果）

基金代码为纯数字：110011、005827。

命令参考

行情（quote 和 market 无需登录）

snowball quote SH600519                  # 实时行情
snowball quote SH600519 SZ000858 AAPL    # 批量查询
snowball quote SH600519 --detail         # PE、PB、股息率、52 周高低
snowball market                          # 大盘指数总览
snowball pankou SH600519                 # 盘口 / 买卖五档
snowball kline SH600519                  # 日 K 线，默认 120 根
snowball kline SH600519 --period week --count 52
snowball minute SH600519                 # 分时图

财务报表

snowball income SH600519 --count 10      # 利润表
snowball balance SH600519                # 资产负债表
snowball cashflow SH600519               # 现金流量表
snowball indicator SH600519              # 关键指标
snowball business SH600519               # 营收构成
snowball forecast SH600519               # 盈利预测

公司资料（F10）

snowball company SH600519                # 公司简介
snowball holders SH600519 --top          # 十大股东
snowball bonus SH600519                  # 分红送转
snowball industry SH600519               # 行业与概念
snowball org SH600519                    # 机构持仓变动

资金流向

snowball flow SH600519 --history         # 历史资金流向
snowball assort SH600519                 # 大/中/小单分布
snowball margin SH600519                 # 融资融券
snowball block SH600519                  # 大宗交易

社交与资讯

snowball trending day --count 10         # 今日热帖
snowball live --important                # 重要快讯
snowball feed a-shares                   # 沪深信息流
snowball hot cn                          # 热门 A 股
snowball kol SH600519                    # 个股大 V
snowball user <用户ID> --count 10        # 用户帖子
snowball profile <用户ID>               # 用户主页
snowball post <帖子ID>                  # 帖子详情

搜索与基金

snowball search 茅台                     # 搜索股票
snowball search-user 价投                # 搜索用户
snowball screen SH                       # 选股器
snowball fund 110011 --nav               # 基金净值（无需登录）

Agent 工作流

早盘简报

snowball market
snowball live --important --count 10
snowball trending --count 5

个股研究

snowball quote SH600519 --detail
snowball income SH600519 --count 8
snowball indicator SH600519 --count 8
snowball holders SH600519 --top
snowball flow SH600519 --history
snowball forecast SH600519

大 V 舆情

snowball kol SH600519 --count 10
snowball user <ID> --count 10
snowball profile <ID>

认证要求速查

无需登录	需要登录
quote market	quote --detail pankou kline minute
fund fund --nav fund --growth	所有财务 / F10 / 资金 / 社交命令

常见问题

• 「Not logged in」 — snowball login 或 snowball token <cookie>
• HTTP 403 / WAF — 等几分钟或重新登录
• Chrome not found — 设置 CHROME_PATH 或 --chrome
• Token 过期 — snowball status 检查，过期重新 login