天天Skills

通过天天基金API查询指定基金代码的详细基金信息，包括基金名称、类型、基金公司、当前净值及风险等级等核心数据。

天天基金信息skill

通过自然语言或结构化参数调用 FUND_BASE_INFOS 对应能力，接口返回 JSON 格式内容。

• 当前 skill 版本：1.0.0

使用方式

1. 在调用任何接口前，必须先检查本地环境变量 TTFUND_APIKEY 是否存在。
2. 若本地已存在 TTFUND_APIKEY，则直接使用该 apikey 发起请求。
3. 若本地不存在 TTFUND_APIKEY，必须强制引导用户先配置 apikey，不得跳过。
4. apikey 获取路径：
   • 打开 天天基金
   • 搜索 skills
   • 在对应 Skills 页面获取 天天基金信息skill 对应的 apikey
5. 当检测到 apikey 缺失时，必须明确提示用户：
   • 当前未检测到本地环境变量 TTFUND_APIKEY，请先前往天天基金搜索 skills 获取 apikey，并在本机配置环境变量后再继续使用。
6. 在用户未完成 apikey 配置前，不继续执行 skill 查询请求。
7. 配置完成后，使用 POST 请求调用统一网关接口，并将 apikey 放入 X-API-Key 请求头中。
8. 每次请求体都必须同时携带 skill_id 和 _skill_version。
9. _skill_version 必须填写当前安装版本：1.0.0。

编写调用方式脚本

curl --location 'https://skills.tiantianfunds.com/ai-smart-skill-service/openapi/skill/invoke' \
--header "X-API-Key: $TTFUND_APIKEY" \
--header 'Content-Type: application/json' \
--data '{
  "skill_id": "FUND_BASE_INFOS",
  "_skill_version": "1.0.0",
  "fcode": "000006"
}'

如果当前底层接口未强制校验 apikey，也必须先检查并要求配置 TTFUND_APIKEY，不可省略该步骤。

请求参数说明

以下表格说明统一网关接收的请求字段及其与下游接口字段的映射关系；fixed 表示系统自动注入，context 表示平台上下文注入。

请求字段	下游字段	来源	类型	必填	说明	示例/默认值
fcode	FCODES	query	string	是	基金代码，例如 000006	000006
fields	FIELDS	fixed	string	是	固定查询字段列表；系统自动注入	JJGS,ESTDIFF,FEGMRQ,TTYPE,YDDT_FY,ESTABDATE,SHRATE7,ISZHDT,DWJZ,ISSBDATE,MBDT_Y,TSRQ,TTYPENAME,MBDT_TRY,ABNORMALDATE,BTYPE,SOURCERATE,SYL_LN,DWDT_TRY,RZDF,PTDT_TRY,YDDT_TRY,NEWINDEXTEXCH,ETFCODE,RSFUNDTYPE,MAXRGINVESTED,DWDT_Y,INDEXNAME,FTYPE,DISCOUNT,LINKZSB,ENDNAV,RATE,PTDT_Y,FCODE,YDDT_Y,FUNDEXCHG,LJJZ,NEWTEXCH,BENCH_CORR,ISABNORMAL_NDATE,MBDT_TWY,FSRQ,RLEVEL_SZ,INDEXCODE,TRKERROR,RLEVEL_CX,BENCHCODE,DWDT_TWY,TJDLIST,MBDT_FY,PTDT_TWY,YDDT_TWY,BFUNDTYPE,DWDT_FY,BAGTYPE,ISSEDATE,SHORTNAME,CYCLE,FEATURE,SHRATE30,RISKLEVEL,SYL_1N,SYL_Z,RSBTYPE,BENCH,MINRG,BESTDT_STRATEGY,MAXSG,PTDT_FY,JJGSID,STDDEV1,MAXRETRA1

问句示例

类型	query
查询 天天基金信息skill	帮我调用 FUND_BASE_INFOS
按示例参数调用	使用 FUND_BASE_INFOS，参数参考请求示例
查询结果解释	帮我读取 FUND_BASE_INFOS 的返回结果并解释关键字段

接口结果释义

一、根节点 (Root Level)

这些是接口最外层的通用状态响应字段。

字段路径	类型	核心释义
data	array	核心业务数据
errorCode	number	接口全局错误码，0 = 成功
firstError	null	首个错误信息，失败时用于定位问题
success	boolean	接口是否成功，true = 成功
hasWrongToken	null	鉴权异常标记
totalCount	number	返回结果数量
expansion	null	扩展字段
jf	string	来源标识

二、核心字段说明

字段 Key	含义说明
success	接口是否成功；true 表示接口调用成功
errorCode	错误码；0 表示成功，非 0 表示失败
totalCount	返回基金数量；本接口通常按基金代码返回对应基金条数
data.FCODE	基金代码列表；用于确认返回的基金代码
data.SHORTNAME	基金简称列表；用于展示基金名称
data.FTYPE	基金类型列表；用于识别基金属于偏股、偏债、指数等类型
data.JJGS	基金公司列表；用于展示基金管理人
data.DWJZ	单位净值列表；用于查看基金当前净值
data.LJJZ	累计净值列表；用于查看基金累计净值表现
data.RISKLEVEL	风险等级列表；用于判断基金风险等级
data.RLEVEL_SZ	基金风险等级（字段一）；用于补充风险标识
data.RLEVEL_CX	基金风险等级（字段二）；用于补充风险标识
data.ESTABDATE	基金成立日期列表；用于判断基金成立时间长短
data.FSRQ	净值日期列表；用于确认当前净值对应日期
data.RATE	当前费率列表；用于查看当前申购费率
data.SOURCERATE	原始费率列表；用于查看原始申购费率
data.SYL_Z	近一周收益率列表；用于评估短期表现
data.SYL_1N	近一年收益率列表；用于评估中期表现
data.SYL_LN	成立以来收益率列表；用于评估长期累计收益表现
data.STDDEV1	波动率列表；用于评估基金波动水平
data.MAXRETRA1	最大回撤列表；用于评估基金回撤风险
data.ESTDIFF	平均估算偏差
data.FEGMRQ	最新净资产日期（净值）
data.TTYPE	主题id（主题占比最高一个）
data.YDDT_FY	移动止盈定投近5年收益
data.SHRATE7	大于7天的赎回费（指数基金）
data.ISZHDT	是否智慧定投（低位多投）
data.ISSBDATE	认购起始日期
data.MBDT_Y	目标止盈定投近1年收益
data.TSRQ	退市日期
data.TTYPENAME	主题名称（主题占比最高一个）
data.MBDT_TRY	目标止盈定投近3年收益
data.ABNORMALDATE	最近一次异常涨幅时间
data.BTYPE	二级分类
data.DWDT_TRY	低位多投定投近3年收益
data.RZDF	日涨跌幅
data.PTDT_TRY	普通定投近3年收益
data.YDDT_TRY	移动止盈定投近3年收益
data.NEWINDEXTEXCH	跟踪指数新市场
data.ETFCODE	ETF联接对应ETF基金
data.RSFUNDTYPE	一级分类 （研究）
data.MAXRGINVESTED	最大认购
data.DWDT_Y	低位多投定投近1年收益
data.INDEXNAME	指数名称
data.DISCOUNT	折扣
data.LINKZSB	是否跳转指数宝3.0
data.ENDNAV	最新净资产（净值）
data.PTDT_Y	普通定投近1年收益
data.YDDT_Y	移动止盈定投近1年收益
data.FUNDEXCHG	超级转换（含QDII）（890IN）
data.NEWTEXCH	场内基金新市场号
data.BENCH_CORR	日收益相关性
data.ISABNORMAL_NDATE	异常涨幅（非公告类)时间
data.MBDT_TWY	目标止盈定投近2年收益
data.INDEXCODE	指数代码
data.TRKERROR	跟踪误差
data.BENCHCODE	业绩基准指数
data.DWDT_TWY	低位多投定投近2年收益
data.TJDLIST	支持条件单类型列表 多个逗号分开
data.MBDT_FY	目标止盈定投近5年收益
data.PTDT_TWY	普通定投近2年收益
data.YDDT_TWY	移动止盈定投近2年收益
data.BFUNDTYPE	基金新类型
data.DWDT_FY	低位多投定投近5年收益
data.BAGTYPE	是否宝类基金
data.ISSEDATE	认购截止日期
data.CYCLE	运作周期（封闭期，无封闭期的为存续期）（PC品种页展示）
data.FEATURE	基金属性
data.SHRATE30	30天的赎回费率
data.RSBTYPE	二级分类（研究）
data.BENCH	业绩比较基准
data.MINRG	首次认购最低额
data.BESTDT_STRATEGY	最佳定投策略
data.MAXSG	最大申购限额
data.PTDT_FY	普通定投近5年收益
data.JJGSID	基金公司id

交互规范

1. 优先检查环境变量 TTFUND_APIKEY。
2. 若环境变量存在，则直接继续调用接口。
3. 若环境变量不存在，必须中断当前调用，并强制提示用户先完成 apikey 配置。
4. 引导文案必须明确包含：
   • 环境变量名：TTFUND_APIKEY
   • apikey 获取路径：天天基金搜索 skills
5. 每次请求都必须带上 skill_id 和 _skill_version。
6. _skill_version 固定使用当前安装版本：1.0.0。
7. 若缺少必填参数，应提示用户补充 fcode。
8. 返回结果时，应优先提炼核心信息，而不是直接原样堆砌所有字段。
9. 结果解释顺序必须是：先看业务结果，再看 version_info，最后决定是否追加升级建议。

输出建议

返回时优先展示：

• success
• errorCode
• totalCount
• data.FCODE
• data.SHORTNAME
• data.FTYPE
• data.JJGS
• data.DWJZ

如需结构化输出，建议包含两部分：

• raw_result：原始接口返回
• explanation_document：对关键字段和结果差异的说明
• version_info：版本状态与升级提示（若返回）

后处理要求：

• 若 data.version_info.is_outdated = true，先完成本次结果回答，再附上一句简洁升级提醒。
• 若接口返回升级导向错误，不要重复盲重试，也不要误判为普通网络问题，应直接提示用户升级 skill。
• 若接口返回普通业务错误且没有版本归因信号，则按原有逻辑处理，不额外渲染升级提示。

错误处理

• 若缺少 apikey，应提示用户：
  • 当前未检测到 TTFUND_APIKEY，请先前往天天基金搜索 skills 获取 apikey，并在本机配置该环境变量后重试。
• 若缺少 _skill_version，应提示用户：
  • 当前安装的 skill 可能为旧版本，未携带版本信息。请升级到最新版本 1.0.0 后重试。
• 若 _skill_version 为空或无效，应提示用户：
  • 当前安装的 skill 版本信息无效，可能为旧版本或安装不完整。请升级到最新版本 1.0.0 后重试。
• 若 HTTP 请求失败、超时或返回非 2xx 状态码，应提示用户：
  • 天天基金信息skill服务暂时不可用，请稍后重试。
• 若返回 version_info 表示本地版本落后，应优先提示用户尽快升级 skill。
• 若版本落后且本次错误属于参数缺失、字段不兼容或调用协议不匹配，应优先提示用户先升级 skill 再重试。
• 若业务成功字段 errorCode 校验失败，则视为业务失败：
  • 简要说明错误信息
  • 不自行猜测结果或伪造成功
• 若核心返回数据为空，应提示用户检查输入参数是否正确。

安全与边界

• 该 Skill 返回的是 天天基金信息skill 对应的业务数据，请按业务场景谨慎使用。
• 返回内容仅用于当前用户请求的查询与分析，不应伪造结果或输出未验证内容。