核心用法
wen-cai 是同花顺问财官方API的聚合封装技能,通过单一入口覆盖12类专业金融数据场景。用户仅需配置 IWENCAI_BASE_URL 和 IWENCAI_API_KEY 两个环境变量,无需安装任何第三方依赖即可调用。
数据查询类(query2data接口):行情数据、指数点位、财务指标(营收/净利润/ROE/负债率/现金流/毛利率)、公司基本资料、事件数据(业绩预告/增发配股/股权质押/限售解禁/机构调研/监管函)、公司经营信息(主营业务/客户/供应商/重大合同)、机构评级与目标价、A股智能选股、板块筛选。
内容搜索类(comprehensive/search接口):研报搜索、公告查询(年报/分红/回购/资产重组)、财经新闻与政策资讯。
支持自然语言查询自动改写为标准金融语句,内置分页机制(默认limit=10),空数据时自动重试(最多2次),响应以结构化表格呈现并强制标注数据来源。
显著优点
1. 功能高度聚合:单一技能替代12个独立接口,大幅降低集成复杂度
2. 零依赖部署:仅使用Python标准库(urllib/json/os),兼容所有Python环境
3. 权威数据源:同花顺问财为国内头部金融数据服务商,数据覆盖A股全市场
4. 智能路由:自动识别用户意图匹配对应接口,无需手动选择channel
5. 金融场景全覆盖:从实时行情到历史财务,从公司微观到宏观政策,形成完整投研闭环
潜在局限
- 地域限制:主要覆盖A股市场,港股、美股、期货等品种支持有限
- 实时性约束:部分财务数据存在披露滞后,非实时行情可能存在分钟级延迟
- 查询复杂度:过度复杂的复合条件可能导致解析失败,建议拆分为多次调用
- 商业授权:需有效API Key,免费额度有限,重度使用需付费订阅
适合人群
量化研究员、个人投资者、财经分析师、智能投顾开发者、金融数据产品经理
常规风险
- 投资风险:提供的数据仅供参考,不构成投资建议,历史表现不代表未来收益
- 数据延迟风险:行情数据非交易所直连,极端行情下可能存在延迟
- API稳定性:依赖同花顺服务端可用性,建议实现本地缓存与降级策略
- 合规使用:需遵守问财开放平台服务协议,禁止未经授权的数据再分发