YH Finance APIs

程序化获取实时股票报价、OHLCV K线、公司基本面、财报日历、选股器与财经新闻。用于构建交易应用、组合看板与投研工具，数据实时同步，被全球金融科技与交易平台广泛使用。

🔍

股票代码与关键词自动补全

股票、ETF 与指数的输入联想与关键词搜索，为交易与研报应用提供搜索框与代码选择器。用户输入时返回匹配代码与实体，实现快速代码发现。

GET /api/project/yh-finance/auto-complete

📦

统计时间范围内事件数量

统计指定时间段内财报、拆股、IPO 及经济事件数量，支持请求体中的日期与地区筛选，适用于看板 KPI 与告警阈值。

POST /api/project/yh-finance/calendar-count-events

⭐

获取时间范围内事件列表

按分页、排序与可选字段获取财报、拆股、IPO 及经济事件，请求体支持筛选运算符，便于构建灵活日历流。

POST /api/project/yh-finance/calendar-get-events

🔄

统计某代码讨论数量

获取某股票留言板讨论总数，需使用 market/v2/get-quotes 返回的 messageBoardId，轻量指标适用于社区与情绪看板。

GET /api/project/yh-finance/conversations-count

📡

讨论列表（已弃用）

按排序与分页列出某代码相关讨论。已弃用，新接入请使用 conversations/v2/list。

GET /api/project/yh-finance/conversations-list

🔗

讨论列表（v2）

按 count、offset 与 sort 列出某代码讨论，需使用 market/v2/get-quotes 的 messageBoardId，用于社区与情绪标签页。

GET /api/project/yh-finance/conversations-v2-list

📋

代码与对比 K 线数据（已弃用）

获取单只代码及对比代码的绘图数据。已弃用，请考虑 stock/v2/get-chart 或 stock/v3/get-chart。

GET /api/project/yh-finance/market-get-charts

🌐

获取近期市场财报

按地区与日期范围获取市场近期财报，支持 size 控制条数，用于全市场财报回顾与筛选。

GET /api/project/yh-finance/market-get-earnings

🔍

获取热门自选列表

获取市场热门自选列表，无需参数，返回精选列表，用于发现页与组合模板。

GET /api/project/yh-finance/market-get-popular-watchlists

📦

迷你 K 线（Spark）数据

多代码轻量 OHLCV，一次请求可渲染多只代码的迷你 K 线或 sparkline，可与 market/get-trending-tickers 搭配做 trending 迷你图。

GET /api/project/yh-finance/market-get-spark

⭐

按报价类型分组的代码

按报价类型（股票、ETF、共同基金等）获取代码列表，可选地区与语言，用于标的池与筛选。

GET /api/project/yh-finance/market-get-tickers-by-quote-type

🔄

获取热门代码

按地区获取当前市场热门代码，可与 market/get-spark 搭配画迷你 K 线。无需输入代码，返回当前热门列表。

GET /api/project/yh-finance/market-get-trending-tickers

📡

自选列表详情

通过 userId 与组合 id（pfId）获取指定自选列表的详情，含完整定义与元数据，用于展示或编辑。

GET /api/project/yh-finance/market-get-watchlist-detail

🔗

自选列表表现

获取指定自选列表的表现数据，可选成分与地区，返回收益及相关统计，用于组合与对比视图。

GET /api/project/yh-finance/market-get-watchlist-performance

📋

当日涨幅、跌幅、最活跃

按地区返回当日涨幅榜、跌幅榜与最活跃股票，支持 count、start 分页，为当日预计算列表。

GET /api/project/yh-finance/market-v2-get-movers

🌐

实时报价

获取一只或多只代码的实时报价，逗号分隔代码，region 必填，请求时与数据源同步，用于行情条与下单。

GET /api/project/yh-finance/market-v2-get-quotes

🔍

按地区市场概览

按地区获取市场概览，单次调用 per 地区，无需代码入参，用于看板与顶栏的指数与状态。

GET /api/project/yh-finance/market-v2-get-summary

📦

单篇新闻详情

按 news/v2/list 返回的 UUID 获取单篇新闻全文，用于阅读与深度链接。

GET /api/project/yh-finance/news-v2-get-details

⭐

新闻与流列表

列出最新综合新闻或视频流，或按代码（参数 s）筛选个股新闻，POST body 支持分页（uuids），用于分页财经新闻与视频。

POST /api/project/yh-finance/news-v2-list

🔄

选股器筛选条件

获取选股器可用筛选条件，供 screeners/list 使用，category、quoteType 可缩小范围，用于动态选股 UI 与文档。

GET /api/project/yh-finance/screeners-get-filters

📡

预定义选股器成分

按预定义选股器（如 MOST_ACTIVES）获取成分代码，scrIds 必填，可选 start、count，无需自定义条件即可获得精选列表。

GET /api/project/yh-finance/screeners-get-symbols-by-predefined

🔗

按条件运行选股器

按条件列出涨幅、跌幅、最活跃、共同基金、ETF 等，POST body 传筛选条件，支持自定义与分类筛选。

POST /api/project/yh-finance/screeners-list

📋

某代码所属选股器

获取包含某代码的选股器 ID，代码可从 auto-complete 获取，用于发现与上下文。

GET /api/project/yh-finance/screeners-list-by-ticker

🌐

公司展望

获取某代码的公司展望，含高层业务与成长叙述，可选 region、lang，用于概览与定性研报。

GET /api/project/yh-finance/stock-get-company-outlook

🔍

单只代码财报

获取某代码的财报数据，含历史与即将披露，可选 region、lang，单代码全量财报。

GET /api/project/yh-finance/stock-get-earnings

📦

同业 ESG 风险分数（已弃用）

获取某代码同业 ESG 风险分数。已弃用，请优先使用 stock/get-esg-scores。

GET /api/project/yh-finance/stock-get-esg-score-for-peers

⭐

代码 ESG 分数

获取某代码的 ESG 分数，可选 region、lang，含可持续与风险维度，用于可持续投资。

GET /api/project/yh-finance/stock-get-esg-scores

🔄

代码事件日历

获取某代码的事件日历（IPO、财报、SEC 申报），modules、tickersFilter 必填，可选日期范围，支持多代码。

GET /api/project/yh-finance/stock-get-events-calendar

📡

费用与开支

获取某代码的费用与开支（如基金），可选 region、lang，含费率与开支明细，用于基金对比。

GET /api/project/yh-finance/stock-get-fees-and-expenses

🔗

基本面数据

获取基本面数据，modules（逗号分隔）选择返回块，symbol 必填，可选 region、lang，全面基本面。

GET /api/project/yh-finance/stock-get-fundamentals

📋

期货链

获取某代码的期货链，可选 region、lang，含合约与到期，用于衍生品工作流。

GET /api/project/yh-finance/stock-get-futures-chain

🌐

代码近期动态

获取某代码近期动态，可选 region、lang，按时间排序，用于动态流。

GET /api/project/yh-finance/stock-get-recent-updates

🔍

推荐趋势

获取推荐趋势（分析师一致预期趋势），可选 region、lang，一段时间内的汇总推荐（买/持/卖）。

GET /api/project/yh-finance/stock-get-recommendation-trend

📦

代码 SEC 申报

获取某代码的 SEC 申报列表，可选 region、lang，含类型与日期，用于合规与研报。

GET /api/project/yh-finance/stock-get-sec-filings

⭐

代码前十大持仓

获取某代码（如基金或 ETF）的前十大持仓，可选 region、lang，含权重，用于持仓结构视图。

GET /api/project/yh-finance/stock-get-top-holdings

🔄

分析师观点

获取一只或多只代码的“分析师观点”区块，代码逗号分隔，可选 region、lang，叙述与要点。

GET /api/project/yh-finance/stock-get-what-analysts-are-saying

📡

K 线数据（v2）

获取全屏 K 线绘图数据，支持 range、interval 或 period1/period2，可选 region，OHLCV 用于图表与回测。

GET /api/project/yh-finance/stock-v2-get-chart

🔗

代码简报（v2）

获取某代码的简报，单代码，短报与要点用于快速了解。

GET /api/project/yh-finance/stock-v2-get-insights

📋

相似与推荐代码

获取与指定代码相似或常被对比的代码，单代码输入，用于发现与对比。

GET /api/project/yh-finance/stock-v2-get-recommendations

🌐

财务时间序列（季/年）

获取财务标签中的季报或年报数据，type 选择指标，period1、period2 选区间，用于图表与模型的历史基本面。

GET /api/project/yh-finance/stock-v2-get-timeseries

🔍

K 线数据（v3）

获取带对比、事件（分红、拆股）及盘前盘后的全屏 K 线数据，range、interval 必填，专业级 K 线。

GET /api/project/yh-finance/stock-v3-get-chart

📦

代码持有人

获取某代码的持有人（机构、主要、内部人），可选 region、lang，用于持仓结构与筛选。

GET /api/project/yh-finance/stock-v3-get-holders

⭐

代码简报（v3）

获取某代码的简报，新项目建议使用 v3 而非 v2，含简报与要点。

GET /api/project/yh-finance/stock-v3-get-insights

🔄

期权报价

获取某代码的期权报价，可选 date、straddle、region、lang，含看涨看跌与执行价、到期。

GET /api/project/yh-finance/stock-v3-get-options

📡

代码简介

获取代码简介（板块、行业、员工数、描述等），可选 region、lang，用于详情页。

GET /api/project/yh-finance/stock-v3-get-profile

🔗

上调与下调历史

获取某代码的上调、下调历史，可选 region、lang，按时间排序的评级变更。

GET /api/project/yh-finance/stock-v3-get-upgrades-downgrades

📋

代码统计

获取某代码的统计指标，建议使用本接口；可选 region、lang，含估值、盈利与市场指标。

GET /api/project/yh-finance/stock-v4-get-statistics

🌐

分析区块（已弃用）

获取分析区块数据。已弃用，请使用基本面或简报接口。

GET /api/project/yh-finance/stock-v2-get-analysis

🔍

资产负债表（已弃用）

获取资产负债表标签数据。请改用 stock/v2/get-timeseries 与 stock/get-fundamentals。

GET /api/project/yh-finance/stock-v2-get-balance-sheet

📦

现金流（已弃用）

获取现金流标签。请改用 stock/v2/get-timeseries 与 stock/get-fundamentals。

GET /api/project/yh-finance/stock-v2-get-cash-flow

⭐

利润表年报（已弃用）

获取利润表年报。请改用 get-timeseries 与 get-fundamentals；季报请用 get-timeseries。

GET /api/project/yh-finance/stock-v2-get-financials

🔄

主要持有人（已弃用）

获取主要持有人标签。请优先使用 stock/v3/get-holders。

GET /api/project/yh-finance/stock-v2-get-holders

📡

持仓标签（已弃用）

获取持仓标签（共同基金），单代码。适用处请用 stock/get-top-holdings。

GET /api/project/yh-finance/stock-v2-get-holdings

🔗

内部人名册（已弃用）

获取持有人区块中的内部人名册。请用 get-fundamentals 或 v3/get-holders。

GET /api/project/yh-finance/stock-v2-get-insider-roster

📋

内部人交易（已弃用）

获取内部人交易标签。请用 get-fundamentals 的 modules。

GET /api/project/yh-finance/stock-v2-get-insider-transactions

🌐

期权区块（已弃用）

获取期权区块数据。请优先使用 stock/v3/get-options。

GET /api/project/yh-finance/stock-v2-get-options

🔍

简介标签（已弃用）

获取简介标签。请优先使用 stock/v3/get-profile。

GET /api/project/yh-finance/stock-v2-get-profile

📦

相似代码（已弃用）

获取相似与推荐代码。请优先使用 stock/v2/get-recommendations。

GET /api/project/yh-finance/stock-v2-get-similarities

⭐

统计标签（已弃用）

获取统计标签。请改用 stock/get-fundamentals 或 stock/v4/get-statistics。

GET /api/project/yh-finance/stock-v2-get-statistics

🔄

摘要区块（已弃用）

获取摘要区块。请改用 market/v2/get-quotes。

GET /api/project/yh-finance/stock-v2-get-summary

📡

上调下调（已弃用）

获取上调与下调。请优先使用 stock/v3/get-upgrades-downgrades。

GET /api/project/yh-finance/stock-v2-get-upgrades-downgrades

🔗

资产负债表 v3（已弃用）

获取资产负债表标签。请改用 get-timeseries 与 get-fundamentals。

GET /api/project/yh-finance/stock-v3-get-balance-sheet

📋

历史数据标签（已弃用）

获取历史数据标签。请改用 stock/get-fundamentals。

GET /api/project/yh-finance/stock-v3-get-historical-data

🌐

统计 v3（已弃用）

获取统计标签。请改用 stock/get-fundamentals 或 stock/v4/get-statistics。

GET /api/project/yh-finance/stock-v3-get-statistics

← Back to Home