聚宽证券元数据 API（股票信息 / ST / 融资融券）

一句话

get_security_info(code) 查单只证券属性；get_all_securities(types=['stock']) 拿全市场证券清单（含上市退市日期）；get_extras('is_st', 列表, 起, 止) 判断股票某时段是否 ST；get_mtss(列表, 起, 止) 取融资融券数据。用它们回答「这只股票能不能碰、是不是 ST、两融资金怎么看」。

当前理解

• get_security_info(code) → 对象，属性：display_name（中文名）、name（简称）、start_date（上市日）、end_date（退市日）、type（stock / index / etf / fja / fjb）、parent（分级基金母基金代码）。
• get_all_securities(types=['stock']) → DataFrame（display_name/name/start_date/end_date/type）；types 默认 ['stock']。
• get_extras(info, security_list, start_date, end_date, df=True) → 判断是否 ST（info='is_st'）。df=True 返回 DataFrame（列=股票代码，行=datetime）；df=False 返回 dict（key=代码，value=ndarray）。示例区间 2015-01-01 ~ 2015-12-31。
• get_mtss(security_list, start_date, end_date, fields=None) → 融资融券 DataFrame，默认全字段。字段：date（日期）、sec_code（代码）、fin_value（融资余额）、fin_buy_value（融资买入额）、fin_refund_value（融资偿还额）、sec_value（融券余额）、sec_sell_value（融券卖出额）、sec_refund_value（融券偿还额）、fin_sec_value（融资融券余额）。
• 两融是什么：融资 = 借钱买股（杠杆做多），融券 = 借券卖出（做空工具）；fin 前缀 = 融资、sec 前缀 = 融券。
• 在策略里的角色：股票池过滤的落地件——排除 ST（get_extras）、按上市日期排除次新（get_all_securities 的 start_date）、停牌（get_current_data 的 paused，见 jq-data-api）；两融数据可作资金面/情绪类因子输入。

来源

• 股票数据 — 全部内容
• raw 路径：原始出处（已归档）
• 关联：股票池（交易对象范围与过滤）（过滤需求）、聚宽行情与财务数据获取 API（价格/财务族）、市值轮动策略 2.0（「过滤 ST」的思想来源）

常见混淆

• get_all_securities vs get_index_stocks：前者是平台支持证券的全量注册表（含上市退市），后者只取某指数成分；「全市场股票池」两者都能拼，口径不同。
• fin / sec 前缀：fin_value 是融资余额，sec_value 是融券余额；两融表里「融资偿还额」「融券偿还额」分别对应 fin_refund_value / sec_refund_value（老教程表格里两处中文注释疑似写串，见开放问题）。
• type 的 fja/fjb：分级基金 A/B 类份额，不是股票——做股票池别把 types 放太宽。
• is_st 是时段查询：get_extras 要起止日期，返回该时段每天是否 ST，不是「现在是不是」。

开放问题

• [需要验证] raw 字段表两处中文注释疑似笔误（sec_sell_value / sec_refund_value 写成「融资…」应为「融券…」），以官方字段定义为准。
• [需要验证] get_extras 除 'is_st' 外还支持哪些 info（raw 未展开）。
• [需要验证] get_mtss 的字段全集（raw 列 9 个）与停牌期数据行为。