通过 MCP 把网站数据接入你的 AI
能查什么数据
指数
指数基础信息
包含指数代码、名称、发布机构、基准日期与基点、分类、加权方式和指数说明。
查询范围:网站支持的所有指数。
可以这样问:沪深300、中证500和中证1000在覆盖范围、分类和加权方式上有什么区别?如果同时持有,它们分别提供了哪些市场暴露?
查看全部 13 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 指数代码 | code |
| 指数市场(CSI=中证指数、CNI=国证指数、SSE=上交所指数、SZSE=深交所指数、VI=虚拟指数) | market |
| 指数简称 | shortName |
| 指数全称 | fullName |
| 指数发布机构 | publisher |
| 上市日期(毫秒时间戳) | listAt |
| 终止日期(毫秒时间戳) | expireAt |
| 基准日期(毫秒时间戳) | baseAt |
| 基准点位 | basePoint |
| 分类 | category |
| 加权方式 | weightingMethod |
| 指数说明 | description |
指数
指数每日行情
包含开盘点位、最高点位、最低点位、收盘点位、前一交易日收盘点位、涨跌点数、涨跌幅、成交量和成交金额。
查询范围:根据指数和年份;或指定一个交易日,查询当日全部指数记录。
可以这样问:对比沪深300和中证500在2025年的涨跌幅、最大回撤和回撤修复时间,哪一个更考验持有耐心?尚未修复的回撤也请标出来。
查看全部 11 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 收盘点位 | close |
| 开盘点位 | open |
| 最高点位 | high |
| 最低点位 | low |
| 前一交易日收盘点位 | preClose |
| 涨跌点数 | change |
| 涨跌幅(0.01 表示 1%) | changePercent |
| 成交量(单位:手) | volume |
| 成交额(单位:元) | amount |
指数
指数成分股
可获取指数历史不同时期的成分股明细,包含指数内部代码、成分股内部代码和快照日期。需要名称时,可结合股票基础信息补全。
查询范围:根据指数和年份,返回这一年的成分快照数据。
可以这样问:对比沪深300在2025年已有的成分快照,名单发生了哪些变化?结合行业分类,看指数结构向哪些行业倾斜。
查看全部 3 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 成分股内部代码 | constituentInnerCode |
| 快照日期(毫秒时间戳) | tradeAt |
指数
指数成分股权重
可获取指数历史不同时期的成分股代码、成分股权重和快照日期,适合查看指数的权重分布与变化。(月末更新)
查询范围:根据指数和年份,返回这一年的成分快照数据。
可以这样问:按2025年最新的权重快照,沪深300前十大成分合计占多少?如果最大权重股下跌10%、其余不变,指数大约会受到多大影响?
查看全部 4 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 成分股内部代码 | constituentInnerCode |
| 成分股权重(0.01 表示 1%) | weight |
| 快照日期(毫秒时间戳) | tradeAt |
指数
指数股息率(TTM)
包含滚动股息率、历史及近 5 / 10 年分位与均值。
查询范围:根据指数和年份;或指定一个交易日,查询当日全部指数记录。
可以这样问:沪深300在2025年最新的股息率,处于历史及近五年的什么位置?零股息成分占多少权重,高股息是否意味着每只成分股都在分红?
查看全部 12 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 滚动股息率(TTM;0.01 表示股息率 1%) | dividendYieldTtm |
| 全部历史分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | historyPercentile |
| 近 10 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year10Percentile |
| 近 5 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year5Percentile |
| 近 10 年平均股息率(0.01 表示股息率 1%;历史不足时为 null) | year10Average |
| 近 5 年平均股息率(0.01 表示股息率 1%;历史不足时为 null) | year5Average |
| 总成分股数量 | totalConstituentCount |
| 有效成分股数量 | validConstituentCount |
| 零股息成分股数量 | zeroDividendCount |
| 零股息成分权重合计 | zeroDividendWeight |
指数
指数等权市盈率(PE TTM)
包含等权 PE TTM、全部历史及近 5 / 10 年分位与均值。
查询范围:根据指数和年份;或指定一个交易日,查询当日全部指数记录。
可以这样问:沪深300的等权市盈率在2025年经历了怎样的估值扩张或收缩?回测一下在不同均值分位买入,未来不同持有期限的收益如何?
查看全部 9 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 等权市盈率(PE TTM) | equalWeightedPeTtm |
| 全部历史分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | historyPercentile |
| 近 10 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year10Percentile |
| 近 5 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year5Percentile |
| 近 10 年平均等权市盈率(PE TTM;历史不足时为 null) | year10Average |
| 近 5 年平均等权市盈率(PE TTM;历史不足时为 null) | year5Average |
| 总成分股数量 | totalConstituentCount |
指数
指数等权市净率(PB TTM)
等权 PB TTM、全部历史及近 5 / 10 年分位与均值。
查询范围:根据指数和年份;或指定一个交易日,查询当日全部指数记录。
可以这样问:沪深300在2025年哪些阶段的等权市净率低于近五年均值?回测一下在不同均值分位买入,未来不同持有期限的收益如何?
查看全部 9 个字段
| 字段含义 | 接口字段 |
|---|---|
| 指数内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 等权市净率(PB TTM) | equalWeightedPbTtm |
| 全部历史分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | historyPercentile |
| 近 10 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year10Percentile |
| 近 5 年分位(0.01 表示 1% 分位;历史不足或不可计算时为 null) | year5Percentile |
| 近 10 年平均等权市净率(PB TTM;历史不足时为 null) | year10Average |
| 近 5 年平均等权市净率(PB TTM;历史不足时为 null) | year5Average |
| 总成分股数量 | totalConstituentCount |
ETF
ETF 基础信息
包含代码与名称、跟踪指数、基金管理人、分类、成立及上市日期、上市状态。
查询范围:全量查询 ETF 基础信息,按需选择字段。
可以这样问:同样跟踪沪深300的ETF有哪些?按规模大小排序。
查看全部 13 个字段
| 字段含义 | 接口字段 |
|---|---|
| ETF 内部代码 | innerCode |
| 交易所(SSE=上海证券交易所、SZSE=深圳证券交易所、BSE=北京证券交易所) | exchange |
| ETF 代码 | code |
| ETF 简称 | shortName |
| ETF 扩展简称 | extendedShortName |
| ETF 全称 | fullName |
| 跟踪指数内部代码 | trackingIndexInnerCode |
| 跟踪指数名称 | trackingIndexName |
| 基金管理人 | managementCompany |
| 分类 | category |
| 成立日期(毫秒时间戳) | inceptionAt |
| 上市日期(毫秒时间戳) | listAt |
| 上市状态(PENDING=待上市、LISTED=已上市、DELISTED=已退市) | listingStatus |
ETF
ETF 每日行情
包含每日开盘价、最高价、最低价、收盘价、昨收价、涨跌额、涨跌幅,以及成交量和成交额。
查询范围:根据 ETF 和年份;或指定一个交易日,查询当日全部 ETF 记录。
可以这样问:华泰柏瑞沪深300ETF在2025年跌幅最大的几天,成交额有没有明显放大?再按收盘价计算最大回撤,看看波动主要集中在哪些时段。
查看全部 11 个字段
| 字段含义 | 接口字段 |
|---|---|
| ETF 内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 开盘价 | open |
| 收盘价 | close |
| 前一交易日收盘价 | preClose |
| 涨跌额 | change |
| 涨跌幅(0.01 表示 1%) | changePercent |
| 成交量(单位:手,1 手=100 份) | volume |
| 成交额(单位:元) | amount |
| 最低价 | low |
| 最高价 | high |
ETF
ETF 每日规模与净值
包含历史每日总份额、基金净资产和单位净值,可以用来跟踪基金规模的变化。
查询范围:根据 ETF 和年份;或指定一个交易日,查询当日全部 ETF 记录。
可以这样问:华泰柏瑞沪深300ETF在2025年的规模变化,主要来自净值涨跌还是份额增减?找出净值下跌、份额却连续增加的阶段。
查看全部 5 个字段
| 字段含义 | 接口字段 |
|---|---|
| ETF 内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 基金总份额(单位:份) | shares |
| 基金净资产(单位:元) | netAssets |
| 单位净值 | nav |
ETF
ETF 净申赎与折溢价
包含历史每日的净申赎份额、金额和比率、折溢价率。
查询范围:根据 ETF 和年份;或指定一个交易日,查询当日全部 ETF 记录。
可以这样问:华泰柏瑞沪深300ETF在2025年有没有“越跌越买”的迹象?把净申赎金额与每日涨跌对照,再看看资金集中流入时是否出现较高溢价。
查看全部 6 个字段
| 字段含义 | 接口字段 |
|---|---|
| ETF 内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 净申赎份额(单位:份;正值为净申购,负值为净赎回) | netSubscriptionShares |
| 净申赎金额(单位:元;按当日单位净值计算,正值为净申购,负值为净赎回) | netSubscriptionAmount |
| 净申赎率(0.01 表示 1%;相邻交易日份额变化除以前一交易日份额) | netSubscriptionRate |
| 折溢价率(0.01 表示 1%;收盘价/单位净值 - 1,正值为溢价,负值为折价) | premiumRate |
股票
股票基础信息
包含股票和公司名称、股票代码、所属地区、上市板块、交易所、上市及退市日期。
查询范围:全量查询股票基础信息,按需选择字段。
可以这样问:帮我看下 A 股各个板块历年的上市股票数量,按时间轴展示,我想看下 A 股股票数量的增长情况
查看全部 10 个字段
| 字段含义 | 接口字段 |
|---|---|
| 股票内部代码 | innerCode |
| 股票代码 | code |
| 股票名称 | name |
| 公司名称 | companyName |
| 地区 | region |
| 上市板块(MAIN=主板、GEM=创业板、STAR=科创板、NEEQ=北交所) | board |
| 交易所(SSE=上海证券交易所、SZSE=深圳证券交易所、BSE=北京证券交易所) | exchange |
| 是否退市(true=已退市、false=未退市) | isDelisted |
| 上市日期(毫秒时间戳) | listAt |
| 退市日期(毫秒时间戳) | delistAt |
股票
股票每日估值与交易指标
包含收盘价、换手率、自由流通换手率、量比、市盈率、市净率、股息率、市销率、股本,以及总市值和流通市值。
查询范围:根据股票和年份;或指定一个交易日,查询当日全市场记录。
可以这样问:在2025年最后一个交易日,筛出市盈率为正且低于15倍、股息率高于3%的股票,结合换手率和流通市值,区分“估值低”与“成交冷清”。
查看全部 18 个字段
| 字段含义 | 接口字段 |
|---|---|
| 股票内部代码 | innerCode |
| 交易日(毫秒时间戳) | tradeAt |
| 收盘价 | close |
| 换手率(0.01 表示 1%) | turnoverRate |
| 自由流通换手率(0.01 表示 1%) | turnoverRateFree |
| 量比 | volumeRatio |
| 市盈率 | pe |
| 滚动市盈率(PE TTM) | peTtm |
| 市净率 | pb |
| 市销率 | ps |
| 滚动市销率(PS TTM) | psTtm |
| 股息率 | dividendRatio |
| 滚动股息率(TTM) | dividendTtmRatio |
| 总股本(单位:股) | totalShare |
| 流通股本(单位:股) | floatShare |
| 自由流通股本(单位:股) | freeShare |
| 总市值(单位:元) | totalMarketValue |
| 流通市值(单位:元) | floatMarketValue |
股票
股票季度基础财务
目前仅有营业收入、扣非净利润,以及对应的股票内部代码、财务年份和季度。
查询范围:指定一只股票,查询全部财务记录;或指定年份 + 季度,查询全市场记录。
可以这样问:对比贵州茅台近五年相同季度的营收和扣非净利润增速,哪些时期出现“增收不增利”?
查看全部 5 个字段
| 字段含义 | 接口字段 |
|---|---|
| 股票内部代码 | innerCode |
| 财务年份(YYYY) | year |
| 财务季度(1=第一季度、2=第二季度、3=第三季度、4=第四季度) | quarter |
| 营业收入(营收;单位:元;单季度值,非年初至今累计值) | revenue |
| 扣非净利润(单位:元;单季度值,非年初至今累计值) | adjustedNetProfit |
市场
交易所每日融资融券汇总
沪深京交易所的融资融券余额、融资买入和偿还额、融券卖出量及余量。
查询范围:根据交易所和年份;或指定交易日查询当日各交易所记录。
可以这样问:给我展示最近十年两融余额的变化
查看全部 9 个字段
| 字段含义 | 接口字段 |
|---|---|
| 交易所(SSE=上海证券交易所、SZSE=深圳证券交易所、BSE=北京证券交易所) | exchange |
| 交易日(上海时区零点的毫秒时间戳) | tradeAt |
| 融资余额(单位:元)。本日融资余额 = 上一交易日融资余额 + 本日融资买入额 - 本日融资偿还额。 | financingBalance |
| 融资买入额(单位:元) | financingPurchaseAmount |
| 融资偿还额(单位:元) | financingRepaymentAmount |
| 融券余额(单位:元)。单只股票的本日融券余额 = 本日融券余量(股) × 本日收盘价(元/股)。交易所融券余额采用公布的汇总金额。 | lendingBalance |
| 融资融券余额合计(单位:元)。本日融资融券余额 = 本日融资余额 + 本日融券余额。 | totalBalance |
| 融券卖出量(股票按股,基金和存托凭证按份,债券按手) | lendingSellQty |
| 融券余量(股票按股,基金和存托凭证按份,债券按手)。本日融券余量 = 上一交易日融券余量 + 本日融券卖出量 - 本日融券偿还量。 | lendingOutstandingQty |
市场
证券每日融资融券明细
股票、ETF 的每日融资融券明细,含北交所标的及退市证券的历史记录。
查询范围:根据证券代码和年份;或指定交易日查询当日所有证券的两融数据。
可以这样问:查询 510300.SSE 在 2026 年的融资余额和融券余额走势。
查看全部 10 个字段
| 字段含义 | 接口字段 |
|---|---|
| 证券内部代码,例如 510300.SSE | innerCode |
| 交易日(上海时区零点的毫秒时间戳) | tradeAt |
| 融资余额(单位:元)。本日融资余额 = 上一交易日融资余额 + 本日融资买入额 - 本日融资偿还额。 | financingBalance |
| 融资买入额(单位:元) | financingPurchaseAmount |
| 融资偿还额(单位:元) | financingRepaymentAmount |
| 融券余额(单位:元)。单只股票的本日融券余额 = 本日融券余量(股) × 本日收盘价(元/股)。交易所融券余额采用公布的汇总金额。 | lendingBalance |
| 融资融券余额合计(单位:元)。本日融资融券余额 = 本日融资余额 + 本日融券余额。 | totalBalance |
| 融券卖出量(股票按股,基金和存托凭证按份,债券按手) | lendingSellQty |
| 融券偿还量(股票按股,基金和存托凭证按份,债券按手) | lendingRepaymentQty |
| 融券余量(股票按股,基金和存托凭证按份,债券按手)。本日融券余量 = 上一交易日融券余量 + 本日融券卖出量 - 本日融券偿还量。 | lendingOutstandingQty |
市场
交易所日报
查看沪深两市不同板块的每日交易数据,包括总市值、流通市值、成交额、成交量和挂牌证券数量。
查询范围:根据交易所、板块和年份;或指定交易日查询当日所有板块数据。
可以这样问:科创板和创业板哪边更活跃?用最近 60 个交易日的每日成交额除以流通市值,对比两个板块的中位数,并找出差距最大的几个交易日。
查看全部 8 个字段
| 字段含义 | 接口字段 |
|---|---|
| 交易所(SSE=上海证券交易所、SZSE=深圳证券交易所) | exchange |
| 交易所板块(SSE_STAR=科创板、SSE_MARKET_TOTAL=沪市合计、SSE_A_SHARES=沪市A股、SSE_B_SHARES=沪市B股、SZSE_GEM=创业板、SZSE_MAIN_BOARD=深市主板、SZSE_MARKET_TOTAL=深市合计) | exchangeSegmentCode |
| 交易日(上海时区零点的毫秒时间戳) | tradeAt |
| 总市值(单位:人民币亿元) | totalMarketValue |
| 流通市值(单位:人民币亿元) | floatMarketValue |
| 成交额(单位:人民币亿元) | amount |
| 成交量(单位:亿股) | volume |
| 挂牌证券数量(单位:个) | listedSecurityCount |
行业与日历
申万行业分类与成分
股票代码与名称,以及对应的申万一级、二级、三级行业代码和行业名称。
查询范围:全量查询行业映射,按需选择字段。
可以这样问:如果我同时持有贵州茅台、五粮液和泸州老窖,按申万一二三级行业看,这算分散投资吗?把三家公司的行业归属并排列出。
查看全部 8 个字段
| 字段含义 | 接口字段 |
|---|---|
| 申万一级行业代码 | level1Code |
| 申万一级行业名称 | level1Name |
| 申万二级行业代码 | level2Code |
| 申万二级行业名称 | level2Name |
| 申万三级行业代码 | level3Code |
| 申万三级行业名称 | level3Name |
| 股票内部代码 | innerCode |
| 股票名称 | name |
行业与日历
交易日历
各交易所的日历日期及是否交易日,包含开市日和休市日。
查询范围:指定年份,查询这一年各交易所的完整交易日历。
可以这样问:找出沪深2026年连续休市至少五天的时段,列出每段休市前最后一个、复市后第一个交易日,做一份交易日清单。
查看全部 3 个字段
| 字段含义 | 接口字段 |
|---|---|
| 交易所(SSE=上海证券交易所、SZSE=深圳证券交易所、BSE=北京证券交易所) | exchange |
| 日历日期(毫秒时间戳) | dateAt |
| 是否交易日(true=交易日、false=休市日) | isTradingDay |
其他
查看剩余调用额度
返回当前 Pro 账户的方案、限额、剩余次数及额度释放时间。查看用量不消耗数据查询额度。
可以这样问:我准备比较几个宽基指数近五年的估值,先查看剩余调用额度,再帮我安排分批查询顺序,优先拿到最有用的数据。
内部代码可先从基础资料中获取。时间覆盖因标的和数据集而异;缺失或不可计算的字段返回空值,近 5 / 10 年指标也可能因历史不足而为空。
如何接入
快速安装方法
把下面这段话复制粘贴到你的 AI 对话中,让它帮你安装
请帮我在当前使用的 AI 工具中安装并配置 ETF Run 数据 MCP,用于查询指数、ETF 和股票等金融数据。 我不是程序员,也不熟悉计算机操作,没有编程或配置工具的经验。请用通俗易懂的中文指导我,不要默认我理解技术术语、会使用命令行或修改配置文件。你能直接完成的操作请帮我完成;必须由我手动操作时,请一次说明一个步骤,明确告诉我打开哪里、点击什么、复制粘贴哪些内容,以及如何判断这一步已完成,等我确认后再继续。 接入说明与数据目录:http://localhost:3000/data-services 请先阅读这个页面,获取 MCP 服务地址、连接类型和认证方式,并按照页面说明完成配置。 目前仅 Pro 用户可以接入。请提示我登录 http://localhost:3000/,点击右上角头像,生成或复制数据密钥,再按当前工具支持的方式完成认证配置。 请根据当前 AI 工具的实际配置方式完成安装;需要我补充信息、确认配置位置、重启工具或手动操作时,请明确告诉我。 安装完成后,请检查 MCP 是否连接成功、能否读取工具列表,并尝试一次数据查询。请说明实际验证结果,以及我下一步需要做什么;如果尚未完成,请说明还缺少哪些操作。最后给我一个可以直接使用的提问示例。
普通安装方法
- 1
获取数据密钥
登录本站,点击右上角头像。首次使用点击“生成你的数据密钥”,已有密钥可以直接复制。
- 2
在 AI 工具中添加 MCP
在工具的 MCP 或连接器设置中添加远程服务,选择 Streamable HTTP,并填写下方地址与认证信息。
- 3
开始提问
连接成功后,可以尝试让 AI 列出可用数据和字段来验证连接成功,然后就可以向 AI 尽情提问了。
连接信息
- 服务地址
https://openapi.etf.run/mcp- 连接类型
- Streamable HTTP(远程 MCP)
- 认证方式
- 添加请求头
Authorization,值为Bearer <你的数据密钥>,例如Bearer etf_skdHGUdYAtSqGggBlRKCqc7QKocsyL1hzk5nTF_KZdY。如果有 Bearer Token 输入框,直接填写数据密钥。
通过 JSON 配置接入
如果你的工具支持 JSON 配置,可参考以下结构,将占位文本替换为数据密钥。具体字段名称以工具的配置要求为准。
{
"mcpServers": {
"etfRun": {
"url": "https://openapi.etf.run/mcp",
"headers": {
"Authorization": "Bearer <你的数据密钥>"
}
}
}
}常见问题
哪些 AI 工具可以接入?
支持添加自定义远程 MCP 或本地 MCP 的 Agent 均可接入,如 WorkBuddy、CodeBuddy、TRAE、OpenClaw(小龙虾)、Claude Code、Codex,等等。
数据权限要求
目前仅 Pro 用户可以接入,开通 Pro 方法可以进入公众号了解。
调用次数是否有限制?
每分钟可调用 20 次接口取数,未来将视服务器资源提升调用次数。
刷新密钥后,需要做什么?
如果你的密钥发生泄露,可以进入头像面板,重置密钥。重置后,旧密钥立即失效。你需要把新的密钥更新到 AI 工具中,再查询数据。
数据和 AI 分析结果可靠吗?
最后要提醒一下,数据可能存在延迟、缺失或错误,AI 可能误读数据、计算出错或生成幻觉,分析结论不保证准确。 本站数据及 AI 生成内容仅供研究参考,不构成投资建议或收益承诺,请独立判断并自行承担投资风险。