用pysnowball轻松打通雪球股票数据接口金融数据分析的完整实战指南【免费下载链接】pysnowball雪球股票数据接口 python edition项目地址: https://gitcode.com/gh_mirrors/py/pysnowball想搭建自己的基金监控工具却被数据源折磨得焦头烂额本文带你认识 pysnowball——一个封装了雪球平台丰富数据能力的 Python 股票数据接口库。无论是实时行情、K线、财务三表、资金流向还是基金净值与持仓它都能用几行代码搞定。这篇文章会从环境搭建讲到实战示例再给出避坑清单让你看完就能动手写自己的金融数据分析脚本。一、为什么你需要一个稳定的行情数据接口先抛三个问题看看你是不是也踩过这些坑免费接口说挂就挂网上随手找的行情接口今天还能用明天就 404代码跟着返工。数据格式五花八门股票一个来源、基金一个来源、财务数据又一个来源字段命名还不统一清洗数据的功夫比写业务逻辑还久。深度数据拿不到想要机构持仓、融资融券、大宗交易这些进阶货普通接口根本不提供。pysnowball 解决的正是这三件事。它把雪球 APP 背后的数据接口统一封装成一个个 Python 函数返回的都是结构清晰的 JSON你不需要关心 Cookie、签名这些底层细节专注业务本身即可。二、一张能力地图这个库到底能拿什么数据在动手写代码之前先花一分钟搞清楚它的家底。pysnowball 的源码按模块划分得井井有条主要分布在 pysnowball/ 目录下实时行情pysnowball/realtime.py报价quotec、详细行情quote_detail、盘口pankou、K线kline财务数据pysnowball/finance.py利润表income、资产负债表balance、现金流量表cash_flow、业绩指标indicator、主营构成business资金动向pysnowball/capital.py当日资金流capital_flow、历史资金流capital_history、成交分布capital_assort、融资融券margin、大宗交易blocktransF10 深度资料pysnowball/f10.py十大股东、股东人数、机构持仓变化、分红融资、行业对比基金数据pysnowball/fund.py基本信息、净值历史、业绩表现、资产配置、基金经理其他亮点指数数据pysnowball/index.py、港股通持股pysnowball/hkex.py、可转债pysnowball/bond.py、组合与自选pysnowball/cube.py换句话说从这只股票现在多少钱到这家公司去年的现金流怎么样一条链路全打通。三、三步完成环境搭建从安装到验证3.1 安装依赖环境干净、版本兼容是后续不踩雷的前提。安装命令很简单pip install pysnowball如果你是离线环境也可以把仓库 clone 下来本地安装git clone https://gitcode.com/gh_mirrors/py/pysnowball cd pysnowball pip install -r requirements.txt3.2 配置雪球 token大部分接口需要携带登录凭证。pysnowball 通过set_token把 token 写入环境变量XUEQIUTOKEN源码逻辑在 pysnowball/token.py。token 的获取方式是登录雪球网页版从浏览器开发者工具的 Cookie 里找到xq_a_token和u两个值拼接而成格式如下import pysnowball as ball # 示例格式xq_a_tokenxxxx;uyyyy ball.set_token(xq_a_token你的token值;u你的用户id)3.3 快速验证 token 是否生效设置完不放心拉一条指数行情试试水quotec这个接口不需要 token但可以顺带验证网络连通性import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) data ball.quotec(SH000001) if data and data.get(error_code) 0: print(token 配置成功上证指数最新价, data[data][0][current]) else: print(token 配置失败请检查后重试)四、实战一搭建股票行情监控脚本4.1 拉取单只股票的实时行情下面这段代码演示了核心用法传入股票代码返回包含现价、涨跌幅、成交量、市值等字段的字典。import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 获取贵州茅台的详细行情 quote ball.quote_detail(SH600519) q quote[data][quote] print(f名称: {q[name]}) print(f最新价: {q[current]}) print(f涨跌幅: {q[percent]}%) print(f市盈率(TTM): {q[pe_ttm]}) print(f市净率: {q[pb]})运行后会打印类似这样的结果注意时间戳是毫秒级的需要除以 1000 再转成可读时间名称: 贵州茅台 最新价: 1712.35 涨跌幅: 1.24% 市盈率(TTM): 28.55 市净率: 8.124.2 批量获取多只股票并计算涨跌幅监控自选股列表是高频场景把多个代码一次性传给quotec它会返回一个列表。下面的脚本会按涨跌幅排序输出import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) symbols SH600519,SZ000858,SH600036,SZ300750 data ball.quotec(symbols) rows [] for item in data[data]: rows.append((item[symbol], item[current], item[percent])) rows.sort(keylambda x: x[2], reverseTrue) for sym, price, pct in rows: print(f{sym}: {price:.2f} 元, 涨跌 {pct:.2f}%)4.3 获取 K 线数据做技术分析kline函数支持多种周期日Kday、周Kweek、月Kmonth、60分K60m、30分K30m、1分K1m。第三个参数控制返回条数import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 获取最近30根日K kdata ball.kline(SH600519, day, 30) for item in kdata[data][item]: # item[0]为时间戳(毫秒), 依次为开、收、高、低 print(item[0], 开:, item[1], 收:, item[2], 高:, item[3], 低:, item[4])五、实战二基金数据一条龙获取基金部分走的是蛋卷基金的数据通道实现在 pysnowball/fund.py接口文档可以参考 APIs/ 目录下的说明。下面这段代码一次拿全基金的核心指标import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) code 008975 info ball.fund_info(code) derived info[data][fund_derived] print(f基金名称: {info[data][fd_name]}) print(f最新净值: {derived[unit_nav]}) print(f日涨跌: {derived[nav_grtd]}%) print(f近1月: {derived[nav_grl1m]}% | 近3月: {derived[nav_grl3m]}% | 近1年: {derived[nav_grl1y]}%)如果要画净值走势就用fund_nav_history分页拉历史净值import pysnowball as ball from datetime import datetime ball.set_token(xq_a_token你的token值;u你的用户id) nav ball.fund_nav_history(008975, page1, size30) for item in nav[data][items]: day datetime.fromtimestamp(item[nav_date] / 1000).strftime(%Y-%m-%d) print(day, 单位净值:, item[unit_nav], 累计净值:, item.get(accum_nav))此外fund_asset能看资产配置占比fund_manager能查基金经理履历fund_achievement能拿业绩排名——做基金筛选报告绰绰有余。六、进阶玩法财务、资金流与指数数据6.1 一键拉取财务报表财务接口统一支持is_annals是否只看年报和count返回条数两个参数import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 最近5份年报的利润数据 income ball.income(SH600519, is_annals1, count5) for row in income[data][list]: # 字段是 [数值, 同比变化] 的结构 print(row[report_name], 营收:, row[total_revenue])财务相关的还有balance、cash_flow、indicatorROE、毛利率等核心指标、business主营构成以及支持美股等市场的*_v2系列函数。6.2 盯住主力资金动向资金面数据对短线跟踪很有用capital_history返回每日净流入capital_assort则把大中小单买卖拆开import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) assort ball.capital_assort(SZ000858) d assort[data] print(f大单买入: {d[buy_large]} | 大单卖出: {d[sell_large]}) print(f中单买入: {d[buy_medium]} | 中单卖出: {d[sell_medium]}) print(f小单买入: {d[buy_small]} | 小单卖出: {d[sell_small]})6.3 指数与港股通数据index_perf_7/30/90可以获取指数近7日、30日、90日的表现northbound_shareholding_sh/sz提供沪深港通持股明细做北向资金观察很方便。七、避坑清单五个高频问题与对策token 失效报错雪球 token 有时效报未设置TOKEN或返回登录错误时重新从浏览器 Cookie 取一次。建议把 token 存到本地文件启动时自动加载。时间戳是毫秒接口返回的时间戳大多需要除以 1000再格式化直接当秒用会得到 1970 年的日期。接口限流频繁请求会被临时限制批量拉数据时务必加延时或限速一般建议每分钟控制在 30 次以内。财务字段是双值数组如total_revenue返回[数值, 同比变动]解析时别只取[0]而忘了同比字段的用处。quote_detail需要 tokenquotec不需要前者返回的字段更全含 PE/PB、涨跌停价、市值但两者鉴权要求不同按场景选用。八、三个让脚本更健壮的小技巧技巧一带重试的请求包装。网络抖动难免给请求加上简单的重试逻辑import time def safe_call(func, *args, retries3, **kwargs): for i in range(retries): try: return func(*args, **kwargs) except Exception as e: print(f第{i1}次请求失败: {e}) time.sleep(1) return None技巧二本地缓存减少重复请求。基金净值这类变化不频繁的数据可以缓存到 JSON 文件设置 24 小时过期能显著降低调用量。技巧三数据合法性校验。拿到返回值先检查error_code是否为 0再检查关键字段是否为空避免把脏数据写进自己的数据库。九、总结与下一步行动回到开头的三个问题数据源不稳定、接口不统一、数据不完整——pysnowball 用一套统一的函数接口把雪球的行情、财务、资金、基金数据串了起来让你从到处找数据的泥潭里解脱出来把精力留给真正的分析和策略。如果你已经准备好动手按这个顺序走一遍执行pip install pysnowball完成安装从雪球网页版 Cookie 中提取 token用ball.set_token配置好运行第四节或第五节的示例脚本验证数据通路在此基础上加入 pandas 做指标计算、matplotlib 画净值走势或者把数据写入 SQLite 做历史归档。数据是分析的起点而 pysnowball 就是这个起点上最顺手的工具。祝你早日跑通第一条数据流水线让数据开始为你说话。【免费下载链接】pysnowball雪球股票数据接口 python edition项目地址: https://gitcode.com/gh_mirrors/py/pysnowball创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用pysnowball轻松打通雪球股票数据接口：金融数据分析的完整实战指南
用pysnowball轻松打通雪球股票数据接口金融数据分析的完整实战指南【免费下载链接】pysnowball雪球股票数据接口 python edition项目地址: https://gitcode.com/gh_mirrors/py/pysnowball想搭建自己的基金监控工具却被数据源折磨得焦头烂额本文带你认识 pysnowball——一个封装了雪球平台丰富数据能力的 Python 股票数据接口库。无论是实时行情、K线、财务三表、资金流向还是基金净值与持仓它都能用几行代码搞定。这篇文章会从环境搭建讲到实战示例再给出避坑清单让你看完就能动手写自己的金融数据分析脚本。一、为什么你需要一个稳定的行情数据接口先抛三个问题看看你是不是也踩过这些坑免费接口说挂就挂网上随手找的行情接口今天还能用明天就 404代码跟着返工。数据格式五花八门股票一个来源、基金一个来源、财务数据又一个来源字段命名还不统一清洗数据的功夫比写业务逻辑还久。深度数据拿不到想要机构持仓、融资融券、大宗交易这些进阶货普通接口根本不提供。pysnowball 解决的正是这三件事。它把雪球 APP 背后的数据接口统一封装成一个个 Python 函数返回的都是结构清晰的 JSON你不需要关心 Cookie、签名这些底层细节专注业务本身即可。二、一张能力地图这个库到底能拿什么数据在动手写代码之前先花一分钟搞清楚它的家底。pysnowball 的源码按模块划分得井井有条主要分布在 pysnowball/ 目录下实时行情pysnowball/realtime.py报价quotec、详细行情quote_detail、盘口pankou、K线kline财务数据pysnowball/finance.py利润表income、资产负债表balance、现金流量表cash_flow、业绩指标indicator、主营构成business资金动向pysnowball/capital.py当日资金流capital_flow、历史资金流capital_history、成交分布capital_assort、融资融券margin、大宗交易blocktransF10 深度资料pysnowball/f10.py十大股东、股东人数、机构持仓变化、分红融资、行业对比基金数据pysnowball/fund.py基本信息、净值历史、业绩表现、资产配置、基金经理其他亮点指数数据pysnowball/index.py、港股通持股pysnowball/hkex.py、可转债pysnowball/bond.py、组合与自选pysnowball/cube.py换句话说从这只股票现在多少钱到这家公司去年的现金流怎么样一条链路全打通。三、三步完成环境搭建从安装到验证3.1 安装依赖环境干净、版本兼容是后续不踩雷的前提。安装命令很简单pip install pysnowball如果你是离线环境也可以把仓库 clone 下来本地安装git clone https://gitcode.com/gh_mirrors/py/pysnowball cd pysnowball pip install -r requirements.txt3.2 配置雪球 token大部分接口需要携带登录凭证。pysnowball 通过set_token把 token 写入环境变量XUEQIUTOKEN源码逻辑在 pysnowball/token.py。token 的获取方式是登录雪球网页版从浏览器开发者工具的 Cookie 里找到xq_a_token和u两个值拼接而成格式如下import pysnowball as ball # 示例格式xq_a_tokenxxxx;uyyyy ball.set_token(xq_a_token你的token值;u你的用户id)3.3 快速验证 token 是否生效设置完不放心拉一条指数行情试试水quotec这个接口不需要 token但可以顺带验证网络连通性import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) data ball.quotec(SH000001) if data and data.get(error_code) 0: print(token 配置成功上证指数最新价, data[data][0][current]) else: print(token 配置失败请检查后重试)四、实战一搭建股票行情监控脚本4.1 拉取单只股票的实时行情下面这段代码演示了核心用法传入股票代码返回包含现价、涨跌幅、成交量、市值等字段的字典。import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 获取贵州茅台的详细行情 quote ball.quote_detail(SH600519) q quote[data][quote] print(f名称: {q[name]}) print(f最新价: {q[current]}) print(f涨跌幅: {q[percent]}%) print(f市盈率(TTM): {q[pe_ttm]}) print(f市净率: {q[pb]})运行后会打印类似这样的结果注意时间戳是毫秒级的需要除以 1000 再转成可读时间名称: 贵州茅台 最新价: 1712.35 涨跌幅: 1.24% 市盈率(TTM): 28.55 市净率: 8.124.2 批量获取多只股票并计算涨跌幅监控自选股列表是高频场景把多个代码一次性传给quotec它会返回一个列表。下面的脚本会按涨跌幅排序输出import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) symbols SH600519,SZ000858,SH600036,SZ300750 data ball.quotec(symbols) rows [] for item in data[data]: rows.append((item[symbol], item[current], item[percent])) rows.sort(keylambda x: x[2], reverseTrue) for sym, price, pct in rows: print(f{sym}: {price:.2f} 元, 涨跌 {pct:.2f}%)4.3 获取 K 线数据做技术分析kline函数支持多种周期日Kday、周Kweek、月Kmonth、60分K60m、30分K30m、1分K1m。第三个参数控制返回条数import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 获取最近30根日K kdata ball.kline(SH600519, day, 30) for item in kdata[data][item]: # item[0]为时间戳(毫秒), 依次为开、收、高、低 print(item[0], 开:, item[1], 收:, item[2], 高:, item[3], 低:, item[4])五、实战二基金数据一条龙获取基金部分走的是蛋卷基金的数据通道实现在 pysnowball/fund.py接口文档可以参考 APIs/ 目录下的说明。下面这段代码一次拿全基金的核心指标import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) code 008975 info ball.fund_info(code) derived info[data][fund_derived] print(f基金名称: {info[data][fd_name]}) print(f最新净值: {derived[unit_nav]}) print(f日涨跌: {derived[nav_grtd]}%) print(f近1月: {derived[nav_grl1m]}% | 近3月: {derived[nav_grl3m]}% | 近1年: {derived[nav_grl1y]}%)如果要画净值走势就用fund_nav_history分页拉历史净值import pysnowball as ball from datetime import datetime ball.set_token(xq_a_token你的token值;u你的用户id) nav ball.fund_nav_history(008975, page1, size30) for item in nav[data][items]: day datetime.fromtimestamp(item[nav_date] / 1000).strftime(%Y-%m-%d) print(day, 单位净值:, item[unit_nav], 累计净值:, item.get(accum_nav))此外fund_asset能看资产配置占比fund_manager能查基金经理履历fund_achievement能拿业绩排名——做基金筛选报告绰绰有余。六、进阶玩法财务、资金流与指数数据6.1 一键拉取财务报表财务接口统一支持is_annals是否只看年报和count返回条数两个参数import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) # 最近5份年报的利润数据 income ball.income(SH600519, is_annals1, count5) for row in income[data][list]: # 字段是 [数值, 同比变化] 的结构 print(row[report_name], 营收:, row[total_revenue])财务相关的还有balance、cash_flow、indicatorROE、毛利率等核心指标、business主营构成以及支持美股等市场的*_v2系列函数。6.2 盯住主力资金动向资金面数据对短线跟踪很有用capital_history返回每日净流入capital_assort则把大中小单买卖拆开import pysnowball as ball ball.set_token(xq_a_token你的token值;u你的用户id) assort ball.capital_assort(SZ000858) d assort[data] print(f大单买入: {d[buy_large]} | 大单卖出: {d[sell_large]}) print(f中单买入: {d[buy_medium]} | 中单卖出: {d[sell_medium]}) print(f小单买入: {d[buy_small]} | 小单卖出: {d[sell_small]})6.3 指数与港股通数据index_perf_7/30/90可以获取指数近7日、30日、90日的表现northbound_shareholding_sh/sz提供沪深港通持股明细做北向资金观察很方便。七、避坑清单五个高频问题与对策token 失效报错雪球 token 有时效报未设置TOKEN或返回登录错误时重新从浏览器 Cookie 取一次。建议把 token 存到本地文件启动时自动加载。时间戳是毫秒接口返回的时间戳大多需要除以 1000再格式化直接当秒用会得到 1970 年的日期。接口限流频繁请求会被临时限制批量拉数据时务必加延时或限速一般建议每分钟控制在 30 次以内。财务字段是双值数组如total_revenue返回[数值, 同比变动]解析时别只取[0]而忘了同比字段的用处。quote_detail需要 tokenquotec不需要前者返回的字段更全含 PE/PB、涨跌停价、市值但两者鉴权要求不同按场景选用。八、三个让脚本更健壮的小技巧技巧一带重试的请求包装。网络抖动难免给请求加上简单的重试逻辑import time def safe_call(func, *args, retries3, **kwargs): for i in range(retries): try: return func(*args, **kwargs) except Exception as e: print(f第{i1}次请求失败: {e}) time.sleep(1) return None技巧二本地缓存减少重复请求。基金净值这类变化不频繁的数据可以缓存到 JSON 文件设置 24 小时过期能显著降低调用量。技巧三数据合法性校验。拿到返回值先检查error_code是否为 0再检查关键字段是否为空避免把脏数据写进自己的数据库。九、总结与下一步行动回到开头的三个问题数据源不稳定、接口不统一、数据不完整——pysnowball 用一套统一的函数接口把雪球的行情、财务、资金、基金数据串了起来让你从到处找数据的泥潭里解脱出来把精力留给真正的分析和策略。如果你已经准备好动手按这个顺序走一遍执行pip install pysnowball完成安装从雪球网页版 Cookie 中提取 token用ball.set_token配置好运行第四节或第五节的示例脚本验证数据通路在此基础上加入 pandas 做指标计算、matplotlib 画净值走势或者把数据写入 SQLite 做历史归档。数据是分析的起点而 pysnowball 就是这个起点上最顺手的工具。祝你早日跑通第一条数据流水线让数据开始为你说话。【免费下载链接】pysnowball雪球股票数据接口 python edition项目地址: https://gitcode.com/gh_mirrors/py/pysnowball创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考