A 股 / 港股 / 美股 / 基金 / 期货 / 期权 / 债券 / 宏观 数据 Skill,提供 241 个数据接口。基于 Tushare 协议,通过 StockToday 自定义后端加速。
⚡ 给 AI 智能体的快速规则 (最重要,先读!)
- 不确定日期: 先调
trade_cal(is_open=1, start_date=今天-7天)找最近交易日- 不确定 ts_code: 调
stock_basic(list_status='L', limit=10)查股票列表- 不确定 token 状态: 调
token_info(token=自己)一次解决- 返空不一定是错: 节假日/未发数据/不存在的股票, 都是空 []。结合 trade_cal 判断
- 同一查询 60 次/分钟: 超限会静默返
ok:false,不要连点- 指数代码传了
daily/weekly/monthly会自动转index_*(LLM 无感, 数据照样返)
核心原则: 用户说人话时, 先 判断任务类型 → 选推荐工具 → 套默认参数, 不要从 241 个 tool 里瞎挑。 下方 10 大任务路由覆盖 95% 真实请求。
daily + pro_bar + daily_basicts_code (1只) 或 trade_date (全市场) 或 start_date+end_date (范围)daily_basic 拿 PE/PB/换手率, 加 adj_factor 算复权income + fina_indicator + balancesheet + cashflowts_code (StockToday 后端硬要求)period 自动取最近季度报告期forecast/ express 看业绩预告, disclosure_date 看披露计划daily_basic + fina_indicator (排序打分)fields 限定index_daily + index_member_all + ths_index/ ths_membersw_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+ 工具按需翻
## 🛠️ 工具列表或 schema:
分类工具基础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 个关键指标排序
核心原则: 用户没明说只要原始表, 就要按"先结论 → 再数据 → 后风险"的方式给, 不要直接吐 JSON 表格。
每次给结果, 严格按这 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, 关注发行价折扣
text
User: 茅台今天怎么样
Step 1: trade_cal(exchange='SSE', start_date='20260615', end_date='20260620', is_open='1')
→ 拿到最近交易日 (e.g. 20260618)
Step 2: daily(ts_code='600519.SH', trade_date='20260618')
→ 拿到 OHLCV 数据
text
User: 茅台 6 月行情
→ daily(ts_code='600519.SH', start_date='20260601', end_date='20260618')
或
→ pro_bar(ts_code='600519.SH', start_date='20260601', end_date='20260618', adj='qfq', freq='D')
(pro_bar 带复权/均线/换手率, 行情分析首选)
text
User: 茅台去年业绩
→ income(ts_code='600519.SH', period='20251231', report_type='1')
period: 报告期末 (年报=1231, 半年报=0630, 一季报=0331, 三季报=0930)
report_type: 1=合并报表(默认) / 2=母公司
不传 period: 返最近一期
text
User: 平安银行 2025 完整财务
→ 3 个并行调用:
income(ts_code='000001.SZ', period='20251231')
balancesheet(ts_code='000001.SZ', period='20251231')
cashflow(ts_code='000001.SZ', period='20251231')
→ 也可以用 fina_indicator(ts_code='000001.SZ', period='20251231') 拿关键比率
text
User: 6/18 上交所龙虎榜
→ top_list(trade_date='20260618')
或加 ts_code='600519.SH' 看单只上榜详情
→ top_inst(trade_date='20260618', ts_code='600519.SH') 看机构席位
text
User: 平安银行 6/18 主力资金
→ moneyflow(ts_code='000001.SZ', trade_date='20260618')
字段: net_mf_vol/net_mf_amount 主力净流, buy_lg/sell_lg 大单, buy_elg/sell_elg 特大单
text
User: 6/18 北向买了多少
→ moneyflow_hsgt(trade_date='20260618')
字段: hgt 沪股通, sgt 深股通, north_money 北向合计
→ hsgt_top10(trade_date='20260618', market_type='1') 沪市北向前 10
text
User: 茅台现在多少钱 (盘中问)
→ rt_tick(ts_code='600519.SH') 最新一笔
→ rt_k(ts_code='600519.SH') 最新 K 线
场景数据可用性备注行情 (日线)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返 {"code":0,"items":[]}节假日/未发数据/股票不存在调 trade_cal 确认日期HTTP 400 (stock_hsgt)缺 ts_code传 ts_code 或 trade_datedata: null (fut/hk 接口)合约/港股代码错检查后缀 (.SHF/.HK)
调 token_info(token=自己) 自动检测自己属于哪一档:
类型适用特征V0 免费注册即得只 6 个基础接口,需要 plugin 解锁V1 基础旗舰积分193 个基础接口 (无实时)V2 高级龙虾套餐全部 193+48 = 241 个V3/V4 高级大客户同 V2
接口分 2 档:
bash
export STOCKTODAY_TOKEN="your_token" # 必填
export STOCKTODAY_URL="https://..." # 可选, 默认 https://tushare.citydata.club/
STOCKTODAY_RATE_PER_MIN=100 (默认)STOCKTODAY_MAX_CONCURRENT=10 (默认)STOCKTODAY_MAX_RETRIES=3 (默认)完整 241 个工具,按 22 个分类列出。 所有 schema 含
type/required/pattern,智能体可直接读dist/tool_schemas.js看详细参数。
工具说明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)...还有 4 个,见下方
工具说明必填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_date
工具说明必填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
工具说明top10_holders十大股东top10_floatholders十大流通股东pledge_stat股权质押统计pledge_detail股权质押明细repurchase股份回购share_float流通股本block_trade大宗交易stk_holdernumber股东户数stk_holdertrade股东增减持 (trade_type: 1=增持/2=减持)
工具说明top_list龙虎榜上榜 (trade_date 必填)top_inst龙虎榜机构席位 (trade_date 必填)limit_list_d涨跌停和炸板数据 (trade_date)limit_list_ths同花顺涨跌停榜单 (trade_date)limit_step涨停连板天梯 (trade_date, 可选 nums='2,3')limit_cpt_list涨停最强板块 (trade_date)stk_auction集合竞价 (trade_date)stk_auction_o开盘竞价成交 (trade_date)stk_auction_c收盘竞价 (trade_date)cyq_perf筹码活跃度 (ts_code + trade_date)cyq_chips筹码分布 (ts_code + trade_date)ccass_hold中央结算持股 (港股)ccass_hold_detail中央结算持股明细stk_ah_comparisonAH 股对比stk_factor_pro股票因子库 (200+ 指标)stk_nineturn九转序列 (技术指标)stk_surv舆情监控report_rc研报
工具说明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)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/动量)
工具说明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)hm_list游资名录hm_detail游资详情tdx_index通达信指数tdx_daily通达信日线tdx_member通达信成分股stk_ah_comparisonAH 股对比
工具说明hk_basic港股基本信息 (注意: 港股代码 5 位,无 .SH/.SZ 后缀)hk_daily港股日线 (ts_code='00700.HK')hk_daily_adj港股复权日线hk_mins港股分钟线hk_income港股利润表 (period='20251231')hk_balancesheet港股资产负债表hk_cashflow港股现金流量表hk_fina_indicator港股财务指标hk_adjfactor港股复权因子hk_hold沪深港通持股 (ts_code + trade_date)us_basic美股基本信息 (代码纯 ticker, e.g. 'AAPL', 无 .US 后缀)us_daily美股日线us_daily_adj美股复权日线us_income / us_balancesheet / us_cashflow / us_fina_indicator美股财务 (period='20251231')us_adjfactor美股复权因子
工具说明fund_basic基金基本信息 (market='O'=场外/'E'='场内)fund_company基金公司fund_manager基金经理fund_share基金份额fund_nav基金净值fund_div基金分红fund_portfolio基金持仓fund_daily基金日线fund_adj基金复权因子fund_factor_pro基金因子
工具说明fut_basic期货基本信息 (exchange='DCE'/'CZCE'/'CFFEX'/'SHFE'/'INE'/'GFEX')fut_daily期货日线 (ts_code='CU2507.SHF' 铜 2507)fut_weekly_monthly期货周月线fut_wsr期货持仓 (symbol='CU')fut_settle期货结算fut_holding期货持仓量 (symbol + start_date + end_date)fut_mapping期货映射opt_basic期权基本信息opt_daily期权日线cb_basic / cb_daily / cb_issue / cb_call / cb_rate / cb_share可转债 (注意: ts_code 6 位, 无后缀)cb_price_chg可转债价格变化cb_factor_pro可转债因子
工具说明realtime_list实时行情列表rt_min股票实时分钟 (ts_code + freq='1MIN'/'5MIN'/'15MIN'/'30MIN'/'60MIN' 大写)rt_k股票实时日线rt_tick股票实时 Tick (只返回最后一条)rt_idx_k / rt_idx_min / rt_idx_tick指数实时rt_sw_k / rt_sw_tick申万指数实时rt_etf_k / rt_etf_min / rt_etf_tickETF 实时rt_fut_min期货实时分钟rt_hk_k / rt_hk_tick港股实时stk_mins股票历史分钟 (ts_code + freq='1min' ~ '60min' 小写)idx_mins指数历史分钟etf_minsETF 历史分钟hk_mins港股历史分钟ft_mins期货历史分钟opt_mins期权历史分钟
工具说明news资讯 (start_date + end_date, src='cls'/'sina'/'ths'/'eastmoney')major_news重要资讯cctv_news新闻联播npr国家政策库anns_d上市公司公告 (ts_code + start_date + end_date)research_report券商研报
工具说明tmt_twincome台湾电子产业月营收tmt_twincomedetailTMT 月营收明细film_record / teleplay_record电影/电视剧备案bo_daily / bo_weekly / bo_monthly / bo_cinema票房irm_qa_sh / irm_qa_sze 互动问答token_info自查 token 状态 (必调用)stk_account / stk_account_old股票账户eco_cal经济日历shibor / shibor_quote / shibor_lprShibor 利率libor / hiborLibor/Hiborus_tbr / us_tycr / us_trycr / us_tltr / us_trltr美债cn_gdp / cn_cpi / cn_ppi / cn_pmi / cn_m中国宏观fx_obasic / fx_daily外汇sge_basic / sge_daily上海黄金bond_blk / bond_blk_detail债券大宗bc_otcqt / bc_bestotcqt银行间报价repo_daily回购yc_cb国债收益率曲线 (ts_code='1001.CB', curve_type='0'/'1')sf_month上海黄金月报gz_index / wz_index国证/万德指数margin / margin_detail / margin_secs融资融券slb_sec / slb_len / slb_sec_detail / slb_len_mm转融通pledge_stat / pledge_detail股权质押repurchase股份回购share_float流通股本block_trade大宗交易stk_holdernumber股东户数stk_holdertrade股东增减持 (trade_type=1 增持/2 减持)report_rc研报stk_surv调研stk_nineturn九转序列stk_factor_pro因子库
v1.3.10: 全删 1.3.5-1.3.9 后重发, 11 文件, 43.8 kB (-46% 体积), 移 INTERFACE.md
v1.3.0+: 透明限流 (60/min, 5 并发, 3 次重试, 静默失败)
v1.2.0+: 全部 240+ 工具的 inputSchema 带 type / required / enum / pattern / default
详细 release notes 见 RELEASE_NOTES.md。
默认 https://tushare.citydata.club/,可通过 STOCKTODAY_URL 环境变量覆盖。
Published via ClawHub · slug: stocktoday