StockToday 自有数据研究技能, 提供 235+ 个数据接口, 后端走 StockToday 自定义加速 ( https://tushare.citydata.club/). 接口命名跟 tushare 100% 兼容, LLM 用标准 tushare 写法即可调用.
⚠️ 没有 token 任何接口都返 TOKEN 无效. 装好 skill 后, 第 1 步 就是配 token.
去 https://stocktoday.cn 注册账号, 在控制台拿 API token.
bash
# Windows PowerShell
$env:TUSHARE_TOKEN = "your_token_here"
# macOS / Linux
export TUSHARE_TOKEN="your_token_here"
bash
TUSHARE_TOKEN=your_token python <skill_dir>/scripts/proxy_demo.py
5 个 demo 全通 (茅台日线 / 财务指标 / 白酒对比 / 资金流 / 板块) = 装好 ✅.
LLM 提示: 装好 skill 后, 主动 告诉用户这 3 步. 不要直接 exec 才发现没 token 报错.
python
import tushare as ts
pro = ts.pro_api("your_token")
pro._DataApi__http_url = "https://tushare.citydata.club/" # 走 stocktoday gateway
df = pro.daily(ts_code="600519.SH", start_date="20240101", end_date="20241231")
详见 scripts/proxy_demo.py, 提供
get_client()封装, 一行初始化完成接入.
python
import sys
sys.path.insert(0, "<skill_dir>/scripts")
from proxy_demo import get_client
pro = get_client("your_token_here")
# 或者从环境变量读:
# export TUSHARE_TOKEN="your_token_here"
# pro = get_client() # 自动读 env
# 然后跟 tushare 官方用法完全一样
df = pro.daily(ts_code="600519.SH", start_date="20240101", end_date="20241231")
print(df.head())
💡 小贴士:
TUSHARE_TOKEN可以用环境变量, 也可以在调用get_client(token=...)时显式传. skill 内部 不存储 任何 token, 也不上传到任何第三方, 流量直连https://tushare.citydata.club/.
核心原则: 用户说人话时, 先 判断任务类型 → 选推荐接口 → 套默认参数, 不要从 235 个接口里瞎挑. 下方 10 大任务路由覆盖 95% 真实请求.
daily + pro_bar + daily_basicdaily_basic 拿 PE/PB/换手率, adj_factor 算复权income + fina_indicator + balancesheet + cashflowperiod 自动取最近季度报告期 (skill 端友好增强)forecast/ express 看业绩预告, disclosure_date 看披露计划daily_basic + fina_indicator (排序打分)fields 限定ts_code 逗号分隔, 一次拉index_daily + index_member_all + ths_index/ ths_memberdaily, 必须用 index_dailysw_daily, 概念用 ths_index, 地域用 dc_indexths_hot / dc_hot 看热度榜moneyflow + moneyflow_hsgt + top_list/ top_instmoneyflow_ind_dc 看板块资金, moneyflow_mkt_dc 看市场资金limit_list_d + limit_step + kpl_list + ths_hot/ dc_hottrade_date=今天, 涨停梯队看 limit_step 的 nums='2,3,4'cyq_perf 看筹码活跃度anns_d + news + major_news + npranns_d 必传 ts_code + start_date + end_dateresearch_report 看券商研报, irm_qa_sh/sz 看互动问答cn_cpi/ppi/pmi/m + us_tycr + hk_daily + us_dailyshibor / shibor_lpr 看利率daily + pro_bar + fina_indicator (按 ts_code+日期范围)daily_600519.SH_20240101_20241231_20260620.csvtoken_info 自查权限 (高级接口需要 V2+)优先从这 29 个里选, 其它 200+ 接口按需翻
references/数据接口.md.
分类接口基础stock_basic, trade_cal, token_info行情daily, pro_bar, daily_basic, adj_factor财务income, balancesheet, cashflow, fina_indicator, forecast, express资金/情绪moneyflow, moneyflow_hsgt, hsgt_top10, top_list, top_inst指数/板块index_daily, index_basic, sw_daily, ths_index, ths_member打板limit_list_d, limit_step, ths_hot, dc_hot公告/宏观anns_d, news, cn_cpi, us_tycr
用户说解释为"最近 / 这段时间"近 20 个交易日"今年 / 今年以来"1 月 1 日至今"财报 / 业绩"最近 8 个季度 + 最近年度"强不强"走势 + 相对强弱 + 活跃度"资金关注"净流入 + 活跃成交 + 龙虎榜/北向"估值"PE / PB / 股息率"对比 / 排前 10"选 3-5 个关键指标排序
核心原则: 用户没明说只要原始表, 就要按"先结论 → 再数据 → 后风险"的方式给, 不要直接吐 pandas DataFrame.
每次给结果, 严格按这 5 段:
复杂度形态适用小Markdown 摘要 + 简短表格1-2 个标的关键指标查询中Markdown 摘要 + CSV (5-1000 行)多标的对比, 区间数据, 财报趋势大Markdown 摘要 + Parquet (1000+ 行)多年日线, 分钟数据, 全市场扫描流程化附 Python 脚本客户要"可复用流程", 或要回测/二次分析
daily)ts_code=600519.SH, start_date=20240101, end_date=20241231)text
📌 结论: 茅台 2024 年累计下跌 8.5%, 跑输沪深 300 (涨 14.7%)
📊 范围: 600519.SH / 2024-01-02 ~ 2024-12-31 / 复权(qfq) / 共 243 个交易日
📈 关键:
- 年初: 1715 元 → 年末: 1569 元 (复权后)
- 区间最大回撤: -23.4% (5-7 月)
- 平均换手率: 0.32%
⚠️ 注意: 6-7 月震荡下行, 9-10 月企稳反弹; 数据按 2026-06-20 拉取
text
📌 结论: 茅台 2025Q3 ROE 24.1% (行业头部), PE 23x (略高于近 5 年中位 20x)
📊 范围: 600519.SH / 8 季度 2023Q4-2025Q3 + 2024 年报
💰 关键 (单位: 亿元):
| 指标 | 2024A | 2025Q3 | 同比 |
|------------|---------|---------|--------|
| 营收 | 1738 | 1285 | +15% |
| 归母净利 | 862 | 638 | +13% |
| ROE | 26.5% | 24.1% | -2.4pp |
| 毛利率 | 91.8% | 91.3% | -0.5pp|
⚠️ 风险: 增速放缓但盈利质量仍优; PE 偏高需关注估值消化
text
📌 结论: 3 只白酒中, 茅台综合最强 (ROE 24%, 毛利率 91%); 泸州老窖增速最快
📊 范围: 600519.SH / 000858.SZ / 000568.SZ / 2024 年报
📊 对比表:
| 指标 | 茅台 | 五粮液 | 泸州老窖 |
|----------|----------|----------|----------|
| ROE | 26.5% | 22.1% | 24.8% |
| 毛利率 | 91.8% | 75.3% | 87.5% |
| 营收增速 | 15.7% | 8.4% | 22.6% |
| PE | 23x | 18x | 20x |
text
📌 结论: 茅台 6/18 主力净流出 2.3 亿 (大单), 但北向净买入 1.1 亿
📊 范围: 600519.SH / 2026-06-18
💰 关键:
- 主力净流入: -2.3 亿 (大单 -1.8 / 特大单 -0.5)
- 北向净买入: +1.1 亿
- 涨跌: -0.42%
⚠️ 解读: 主力减仓但北向接盘, 信号矛盾需看后续 1-2 日确认
text
📌 结论: 6/18 涨停 47 只 (连板 12 只), 半导体板块最热 (涨停 8 只)
📊 范围: 全市场 / 2026-06-18
🔥 板块强度: 半导体 +5.2% / 新能源车 +3.8% / AI +3.1%
📊 连板梯队: 6 板 1 只 / 5 板 2 只 / 4 板 3 只
⚠️ 风险: 涨停炸板率 18% (偏高), 明日分歧概率大
text
📌 结论: 寒武纪 6/18 公告 3 条, 核心是定增预案修订 (募资 50 亿)
📊 范围: 688256.SH / 近 30 日 / anns_d + news
📰 关键:
- 6/18: 定增预案修订 (募资 50 亿, 用于 AI 芯片研发)
- 6/15: 5 月经营数据公告
- 6/10: 投资者关系活动记录
⚠️ 注意: 定增属利好但稀释 EPS, 关注发行价折扣
python
import sys
sys.path.insert(0, "<skill_dir>/scripts")
from proxy_demo import get_client
pro = get_client("your_token_here")
df = pro.daily(ts_code="600519.SH", trade_date="20260618")
print(df)
python
df = pro.daily(ts_code="600519.SH", start_date="20260601", end_date="20260618")
# 或用 pro_bar 拿复权
df = pro.pro_bar(ts_code="600519.SH", start_date="20260601", end_date="20260618", adj="qfq")
python
# 利润表 (不传 period 自动取最近季度报告期)
df = pro.income(ts_code="600519.SH", period="20251231")
# period: 报告期末 (年报=1231, 半年报=0630, 一季报=0331, 三季报=0930)
python
ts_code = "000001.SZ"
period = "20251231"
income = pro.income(ts_code=ts_code, period=period)
balance = pro.balancesheet(ts_code=ts_code, period=period)
cashflow = pro.cashflow(ts_code=ts_code, period=period)
ratios = pro.fina_indicator(ts_code=ts_code, period=period)
python
# 6/18 上交所龙虎榜
df = pro.top_list(trade_date="20260618")
# 或加 ts_code 看单只上榜详情
df = pro.top_list(trade_date="20260618", ts_code="600519.SH")
# 机构席位
df = pro.top_inst(trade_date="20260618", ts_code="600519.SH")
python
# 平安银行 6/18 主力资金
df = pro.moneyflow(ts_code="000001.SZ", trade_date="20260618")
# 字段: net_mf_vol/net_mf_amount 主力净流, buy_lg/sell_lg 大单, buy_elg/sell_elg 特大单
python
# 6/18 北向买了多少
df = pro.moneyflow_hsgt(trade_date="20260618")
# 字段: hgt 沪股通, sgt 深股通, north_money 北向合计
# 沪市北向前 10
df = pro.hsgt_top10(trade_date="20260618", market_type="1")
index_daily, 不要用 daily)#python
# 上证指数 6/18
df = pro.index_daily(ts_code="000001.SH", trade_date="20260618")
# 沪深 300
df = pro.index_daily(ts_code="000300.SH", trade_date="20260618")
# 创业板指
df = pro.index_daily(ts_code="399006.SZ", trade_date="20260618")
python
ts_code = "600519.SH"
period = "20251231"
# 1. 行情
quote = pro.daily(ts_code=ts_code, start_date="20250101", end_date="20251231")
# 2. 财务 3 表 + 指标
income = pro.income(ts_code=ts_code, period=period)
balance = pro.balancesheet(ts_code=ts_code, period=period)
cashflow = pro.cashflow(ts_code=ts_code, period=period)
ratios = pro.fina_indicator(ts_code=ts_code, period=period)
# 3. 资金流
money = pro.moneyflow(ts_code=ts_code, trade_date="20260618")
# 4. 公告
ann = pro.anns_d(ts_code=ts_code, start_date="20260101", end_date="20260618")
场景数据可用性备注行情 (日线)T+1 18:00 后当天数据当晚 6 点后可用行情 (分钟)实时盘中每分钟更新实时 Tick实时盘中每 3 秒财务 (季报)公告日4/30 一季报, 8/30 半年报, 10/30 三季报, 4/30 年报财务 (年报)4/30 前1/1-4/30 是年报披露季业绩预告季报前后1/15, 4/15, 7/15, 10/15 前后集中龙虎榜T+1 18:00 后盘后公布限流阈值100/分钟(perMin=100)
重要: 周末/节假日调接口会返空,这是 正常,不是接口坏。
现象原因解决TOKEN无效token 错/过期调 token_info(token=自己) 看状态参数不能为空必填参数没传看 schema 里的 required: true``您的IP因异常请求已被临时封禁5 分钟内 5+ 次 IP_KEY 错改对 token,等 5h单次查询数据量不可超过 10000 条数据范围太大缩 start_date~end_date返空 []节假日/未发数据/股票不存在调 trade_cal 确认日期HTTP 400 (stock_hsgt)缺 ts_code传 ts_code 或 trade_datedata: null (fut/hk 接口)合约/港股代码错检查后缀 (.SHF/.HK)pro.daily(ts_code='000001.SH') 返空指数代码不能用 daily改用 pro.index_daily(ts_code='000001.SH')
调 token_info(token=自己) 自动检测自己属于哪一档:
类型适用特征V0 免费注册即得只 6 个基础接口,需要 plugin 解锁V1 基础旗舰积分193 个基础接口 (无实时)V2 高级龙虾套餐全部 193+48 = 241 个V3/V4 高级大客户同 V2
接口分 2 档:
完整 235 个工具,按 23 个分类列出。 所有 schema 含
type/required/pattern/enum/default, 详见 references/数据接口.md.
工具说明stock_basic查股票列表: list_status='L' 上市 / 'D' 退市 / 'P' 暂停stk_premarket新股上市trade_cal交易日历: is_open='1' 交易日 / '0' 休市, 节假日调这个stock_stST 股票列表 (需 trade_date)namechange股票名称变更stock_company上市公司信息 (1 只: ts_code)stk_managers公司管理层stk_rewards高管薪酬new_share新股发行 (需 start_date)bak_basic备用基础数据bse_mapping北交所新旧代码对照stock_hsgt沪深港通股票列表 (需 ts_code 或 trade_date)...还有 6 个,见 references/数据接口.md
工具说明必填daily日线行情ts_code + (trade_date | start_date+end_date)weekly周线行情同上monthly月线行情同上pro_bar行情(支持复权)ts_code + start_date + end_date, adj 可选 qfq/hfq/none, freq D/W/Mstk_weekly_monthly周月线行情 (高频首选)ts_code + freq='W' 或 'M'stk_week_month_adj周月线复权同上adj_factor复权因子ts_code + start_date + end_datedaily_basic每日指标 (PE/PB/换手率)ts_code + trade_datestk_limit涨跌停价格ts_code + trade_datesuspend_d停复牌ts_code + start_date + end_datehsgt_top10沪/深股通前 10trade_date + market_type (1=沪/3=深)ggt_top10港股通前 10trade_date + market_type (2=沪/4=深)ggt_daily港股通每日trade_dateggt_monthly港股通每月trade_datebak_daily备用每日行情trade_datestk_mins股票历史分钟ts_code + freq='1min'~'60min' 小写idx_mins指数历史分钟 (必传 ts_code + freq)ts_code + freq...还有 4 个,见 references/数据接口.md
工具说明必填income利润表ts_code + 可选 period/ann_datebalancesheet资产负债表同上cashflow现金流量表同上forecast业绩预告ts_code 或 ann_dateexpress业绩快报ts_code 或 ann_datedividend分红送股ts_codefina_indicator财务指标 (ROE/EPS/PE/PB)ts_code + 可选 periodfina_audit财务审计ts_code + periodfina_mainbz主营业务ts_code + period + type (P=产品/D=地区)disclosure_date披露日期ts_code + end_dateincome_vipVIP 利润表ts_code + periodbalancesheet_vipVIP 资产负债表ts_code + periodcashflow_vipVIP 现金流量表ts_code + periodfina_indicator_vipVIP 财务指标ts_code + periodexpress_vipVIP 业绩快报ts_code + periodforecast_vipVIP 业绩预告ts_code + periodfina_mainbz_vipVIP 主营业务ts_code + period + type
工具说明moneyflow股票资金流向 (ts_code + trade_date)moneyflow_hsgt沪深港通北向 (trade_date)moneyflow_ths同花顺资金流 (ts_code + trade_date)moneyflow_dc东方财富资金流 (ts_code + trade_date)moneyflow_ind_ths同花顺行业资金流 (trade_date)moneyflow_ind_dc东方财富行业资金流 (trade_date)moneyflow_mkt_dc东方财富市场资金流 (trade_date)moneyflow_cnt_ths同花顺概念资金流 (trade_date)
工具说明index_basic指数基本信息 (market='SSE'/'SZSE'/'BSE')index_daily指数日线 (ts_code) - 指数代码必须用这个, 不要用 daily``index_weekly指数周线index_monthly指数月线index_weight指数成分股权重 (index_code + trade_date)index_dailybasic指数每日指标 (PE/PB/换手率)index_classify指数分类index_member_all指数成分股ci_daily中证指数日线sw_daily申万指数日线idx_factor_pro指数因子 (PE/PB/动量)...还有 11 个,见 references/数据接口.md
工具说明ths_index同花顺概念/行业/地域指数ths_daily同花顺指数日线 (ts_code + trade_date)ths_member同花顺成分股 (ts_code)ths_hot同花顺热榜 (trade_date)dc_index东财指数 (idx_type 必填)dc_daily东财指数日线dc_member东财成分股 (trade_date)dc_hot东财热榜 (trade_date)kpl_list开盘啦榜单 (trade_date)kpl_concept开盘啦概念 (trade_date)kpl_concept_cons开盘啦概念成分 (trade_date)limit_list_d涨跌停明细 (trade_date)limit_list_ths同花顺涨跌停榜单 (trade_date)limit_step涨停连板天梯 (trade_date, 可选 nums='2,3')limit_cpt_list涨停最强板块 (trade_date)hm_detail游资详情 (trade_date)
工具说明rt_k股票实时日线 (ts_code 通配符 6*.SH)rt_tick股票实时 Tick (只返回最后一条)rt_min股票实时分钟 (ts_code + freq='1MIN'/'5MIN'... 大写)rt_idx_k / rt_idx_min / rt_idx_tick指数实时rt_etf_k / rt_etf_tickETF 实时rt_fut_min期货实时分钟rt_hk_k / rt_hk_tick港股实时
工具说明hk_basic / hk_daily港股基本信息/日线 (代码 00700.HK)hk_income / hk_balancesheet / hk_cashflow港股三大财务报表 (period='20251231')us_basic / us_daily美股基本信息/日线 (代码纯 ticker, e.g. 'AAPL', 不带 .US)us_income / us_balancesheet / us_cashflow / us_fina_indicator美股财务
fund_basic / fund_nav / fund_daily / fund_portfolio / etf_basic / ...fut_basic (exchange='DCE'/'CZSE'/'CFFEX'/'SHFE'/'INE'/'GFEX') / fut_daily (ts_code='CU2507.SHF' 铜 2507) / ...opt_basic / opt_dailycb_basic / cb_daily / cb_issue / cb_call / cb_rate / cb_share / cb_price_chgrepo_daily / bc_otcqt / bc_bestotcqt / bond_blk / bond_blk_detail / yc_cbcn_cpi (m='202401') / cn_gdp (q='2024Q1') / cn_pmi / cn_m / cn_ppi / shibor / shibor_lpr / us_tycr / hibor / libor / us_tbr / ...news (start_date + end_date, src='cls'/'sina'/'ths'/'eastmoney') / major_news / cctv_news / npr / anns_d / research_reporttoken_info (必调用, 看 token 状态/可用接口)tmt_twincome / film_record / teleplay_record / bo_daily / bo_weekly / bo_monthly / bo_cinema / irm_qa_sh / irm_qa_sz环境变量默认说明TUSHARE_TOKEN(无)必填, 你的 API tokenTUSHARE_GATEWAY``https://tushare.citydata.club/自定义后端地址TUSHARE_GATEWAY_BACKUP1``http://111.229.164.2:8083/备用 gateway 1TUSHARE_GATEWAY_BACKUP2``http://124.223.112.152:6331/备用 gateway 2TUSHARE_GATEWAY_BACKUP3``http://110.42.211.9:9900/备用 gateway 3
症状原因解决ImportError: No module named 'tushare'依赖没装pip install tushare pandas``TOKEN无效token 错/失效/被封调 token_info 自查调工具超时网络问题 / gateway 全挂检查 tushare.citydata.club 通不通频繁返 请求超限20000次token 当日额度用完明日 0 点重置, 或换 token问"今天"返空今天休市 (周末/节假日)改问"最近一个交易日"pro.daily(ts_code='000001.SH') 返空指数代码不能用 daily改用 pro.index_daily(ts_code='000001.SH')
stocktoday-py skill 页面D:\office\stocktoday-data\MIT