Yahoo Finance

Yahoo Finance API

按标的代码读取 Yahoo Finance 行情、历史价格、财务报表、分析师评级、期权及相关新闻,区分市场记录与机构意见,为研究提供数据,不构成投资建议。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 yahoo_finance,action 填下方列表里的能力名,例如 search。

  • 10 个能力
  • 每千次 $1.39 起
  • 失败和空结果都不收费

平台运行状态

24h 健康值
正常
正常

30 天趋势

Yahoo Finance 能力清单

能力做什么单价空白行均为 $1.39 / 千次24 小时运行状态
关键词搜索searchsearch 实际是代码行情查询:keyword 填 AAPL 这类标的代码,并保留非美国市场的交易所后缀,不是公司名全文搜索。正常
历史行情historyhistory 针对一个 keyword 标的,用 period 决定回看跨度、interval 决定每根 K 线的粒度。正常
财务指标financialsfinancials 以单个 keyword 标的返回利润表、资产负债表、现金流量表和可能存在的季度利润表。正常
财经新闻newsnews 用单一 keyword 标的读取相关新闻,保留标题、发布方和链接,方便继续核实事件上下文。正常
分析师评级analystanalyst 针对一个 keyword 标的返回评级分布及机构升降级记录,区分群体分布和单次意见变化。正常
期权链options使用 keyword 作为基础标的读取看涨和看跌期权链,并使用 contract_symbol、strike 和 expiration 区分合约。正常
热榜trendingtrending 无需 keyword,以 screener 选择预设榜单,当前默认 DAY_GAINERS 表示当日涨幅榜。正常
财报与每股收益earnings用 earnings 输入一个美股代码,取回最近已公布季度的每股收益实际值与一致预期,以及往后几个季度的预期。$8 / 千次暂不可用
统计指标statistics用 statistics 输入一个美股代码,取回按主题分节的统计指标,覆盖估值、比率、股本、利润率、分红等方面。$8 / 千次暂不可用
机构持仓institutional_holdings用 institutional_holdings 输入一个美股代码,取回机构持股比例、持仓市值、增减持家数和股数,以及持仓最大的机构名单。$8 / 千次暂不可用

Yahoo Finance 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价空白行均为 $1.39 / 千次返回字段
searchkeywordtickers—id · name · symbol · sector · industry · market_cap · price · currency · quote_type · exchange · pe_ratio · dividend_yield · platform
historykeywordinterval, period—symbol · date · open · high · low · close · volume · dividends · stock_splits · platform
financialskeyword——symbol · income · balance_sheet · cash_flow · quarterly_income · platform
newskeyword——id · url · title · text · publisher · posted_at · symbol · platform
analystkeyword——symbol · recommendation_trend · upgrades_downgrades · platform
optionskeyword——contract_symbol · strike · last_price · bid · ask · volume · open_interest · implied_volatility · in_the_money · expiration · symbol · expiration_dates · strikes · calls · puts · platform
trending—screener默认 10 · 最多 200id · symbol · name · price · change · change_percent · volume · market_cap · currency · exchange · pe_ratio · fifty_two_week_range · platform
earningskeyword——$8 / 千次symbol · quarters · next_earnings_date · next_earnings_timing · analyst_count · platform
statisticskeyword——$8 / 千次symbol · sections · platform
institutional_holdingskeyword——$8 / 千次symbol · institutional_ownership_pct · shares_outstanding · holdings_value_usd · holders · shares_held · increased_holders · increased_shares · decreased_holders · decreased_shares · unchanged_holders · unchanged_shares · new_holders · new_shares · sold_out_holders · sold_out_shares · top_holders · platform

怎么调用 Yahoo Finance 历史行情 API?

history

使用 platform="yahoo_finance"、action="history" 调用“历史行情”能力;返回列表,主要包含 symbol、date、open、high、low、close 等 10 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance history 的参数分别是什么意思?

keyword必填
Yahoo Finance 标的代码,例如 AAPL;不是公司名全文搜索,市场后缀须保留。history 每次针对一个代码返回历史 OHLCV。
interval可选
K 线粒度,默认 1d。1m/2m/5m/15m/30m/60m/90m 是分钟,1h 是小时,1d/5d 是天,1wk 是周,1mo/3mo 是月;1m 不是一个月。分钟粒度与长 period 的组合可能受历史窗口限制。

官方历史数据页面区分时间跨度、数据类型和频率,并说明可用历史范围与许可限制;不代表本接口提供 CSV 下载或同样的完整覆盖。官方来源:Yahoo Finance:历史价格、分红、拆股与频率选择来源核查:

period可选
回看跨度:1d/5d 为一天/五天,1mo/3mo/6mo 为一/三/六个月,1y/2y/5y/10y 为一/二/五/十年,ytd 年初至今,max 可取得的最长历史;默认 1mo,max 不保证上市以来完整数据。

官方定义调整后收盘价涉及拆股和分红调整;当前接口只有 close,不能凭该文档声称响应已经复权。官方来源:Yahoo Finance:Adjusted close 的定义来源核查:

Yahoo Finance 返回字段与含义(9)
symbol
股票代码。
open
开盘价。
close
收盘价。
high
最高价。
low
最低价。
volume
成交量。
date
该条数据的日期。
dividends
分红记录。
stock_splits
拆股记录。

怎么调用 Yahoo Finance 财务指标 API?

financials

使用 platform="yahoo_finance"、action="financials" 调用“财务指标”能力;返回单个对象,主要包含 symbol、income、balance_sheet、cash_flow、quarterly_income、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance financials 的参数分别是什么意思?

keyword必填
Yahoo Finance 标的代码,例如 AAPL;不是公司名全文搜索,市场后缀须保留。financials 每次针对一个代码返回财务表。

Yahoo Finance 官方帮助将公司洞察、基本面研究和多维业务表现列为研究功能;该来源只证明平台提供相应研究资料,不证明 EveryInfra financials 的报表期间、字段全集、审计标准或实时性。keyword 仍应按本页说明填写证券代码。官方来源:Yahoo Finance:公司洞察与财务研究范围来源核查:

Yahoo Finance 返回字段与含义(5)
symbol
股票代码。
income
利润表。
quarterly_income
季度利润表。
balance_sheet
资产负债表。
cash_flow
现金流量表。

怎么调用 Yahoo Finance 财经新闻 API?

news

使用 platform="yahoo_finance"、action="news" 调用“财经新闻”能力;返回列表,主要包含 id、url、title、text、publisher、posted_at 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance news 的参数分别是什么意思?

keyword必填
Yahoo Finance 标的代码,例如 AAPL;不是公司名全文搜索,市场后缀须保留。news 每次针对一个代码返回个股新闻。

Yahoo Finance 官方说明搜索可按公司名或证券代码查找报价、商业新闻与市场信息。EveryInfra news 使用 keyword 定位标的,这是 EveryInfra 自己的请求参数;该来源不证明新闻完整性、排序、授权再分发或固定时间范围。官方来源:Yahoo Finance:按公司或证券代码查找商业新闻来源核查:

Yahoo Finance 返回字段与含义(2)
symbol
股票代码。
publisher
资讯发布方。

怎么调用 Yahoo Finance 分析师评级 API?

analyst

使用 platform="yahoo_finance"、action="analyst" 调用“分析师评级”能力;返回单个对象,主要包含 symbol、recommendation_trend、upgrades_downgrades、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance analyst 的参数分别是什么意思?

keyword必填
Yahoo Finance 标的代码,例如 AAPL;不是公司名全文搜索,市场后缀须保留。analyst 每次针对一个代码返回评级分布和升降级记录,目标价在每条升降级记录里。

Yahoo Finance 官方帮助说明部分订阅计划提供研究报告、recommendations、valuations、technical outlooks 和 ratings。该来源不证明 EveryInfra analyst 的数据供应、共识样本、更新频率或所有证券均有覆盖;keyword 仅按本页说明定位证券。官方来源:Yahoo Finance:研究报告、评级与推荐资料来源核查:

Yahoo Finance 返回字段与含义(3)
symbol
股票代码。
recommendation_trend
分析师评级分布随时间的变化。
upgrades_downgrades
评级调整历史。

怎么调用 Yahoo Finance 期权链 API?

options

使用 platform="yahoo_finance"、action="options" 调用“期权链”能力;返回单个对象,主要包含 contract_symbol、strike、last_price、bid、ask、volume 等 16 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance options 的参数分别是什么意思?

keyword必填
Yahoo Finance 标的代码,例如 AAPL;不是公司名全文搜索,市场后缀须保留。options 每次针对一个代码返回期权链。

官方说明各交易所代码后缀和数据延迟不同,并将数据定位为信息用途;用于解释标的代码与行情时效边界,不证明本接口实时可交易。官方来源:Yahoo Finance:市场代码后缀、延迟与信息用途来源核查:

Yahoo Finance 返回字段与含义(15)
symbol
股票代码。
volume
成交量。
last_price
最新价。
bid
买一价。
ask
卖一价。
calls
看涨期权列表。
puts
看跌期权列表。
strike
行权价。
strikes
全部行权价档位。
expiration
到期日。
expiration_dates
全部到期日。
contract_symbol
期权合约代码。
implied_volatility
隐含波动率。
open_interest
未平仓合约数。
in_the_money
是否为价内期权。

怎么调用 Yahoo Finance 财报与每股收益 API?

earnings

使用 platform="yahoo_finance"、action="earnings" 调用“财报与每股收益”能力;返回单个对象,主要包含 symbol、quarters、next_earnings_date、next_earnings_timing、analyst_count、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance earnings 的参数分别是什么意思?

keyword必填
要查财报的美股代码,例如 AAPL、BRK.B(可带 $);不收公司名。返回已公布季度和接下来几个季度的每股收益与下次财报日;代码查不到不扣费。

Yahoo Finance 官方帮助说明事件日历列出每天的财报发布,并可按证券代码查某只股票的财报日期(Earnings Date)。这里只核对「按一个代码查财报日期」这一对象;该页不说明每股收益的预期、实际和差值字段,也不说明分析师人数、盘前盘后或本接口只收美股代码的限制。官方来源:Yahoo Finance:财报日历可按证券代码查财报日期来源核查:

Yahoo Finance 返回字段与含义(5)
symbol
股票代码。
quarters
按季度的每股收益(earnings):period(财季,如 Sep 2026)、status(reported 已公布 / upcoming 待公布)、eps_estimate(分析师一致预期)、eps_actual(实际,待公布季度没有)、eps_surprise(实际减预期)。
next_earnings_date
下次财报公布日期(earnings,YYYY-MM-DD,预计日期);公司没公布时没有。
next_earnings_timing
下次财报在盘前还是盘后公布(earnings):before_market_open / after_market_close;没说明时没有。
analyst_count
给出下季度 EPS 一致预期的分析师人数(earnings);没有时没有。

怎么调用 Yahoo Finance 统计指标 API?

statistics

使用 platform="yahoo_finance"、action="statistics" 调用“统计指标”能力;返回单个对象,主要包含 symbol、sections、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance statistics 的参数分别是什么意思?

keyword必填
要查统计指标的美股代码,例如 MSFT(可带 $);不收公司名。返回估值、盈利能力、分红等分节指标;代码查不到不扣费。

Yahoo Finance 官方帮助说明查到一只证券后可打开 Statistics 标签页,内容是关键财务数据、估值指标和交易信息。这里只核对「一个代码对应一页统计指标」;该页不列出具体分节和指标名,也不说明数值的格式、更新频率或本接口只收美股代码的限制。官方来源:Yahoo Finance:个股的 Statistics 页来源核查:

Yahoo Finance 返回字段与含义(2)
symbol
股票代码。
sections
统计指标分节(statistics):section(valuation、ratios、shares、margins、dividends 等)、summary(一句话概述)、items(key、label 指标名、value 显示值如 4.94T、raw_value 原始数值文本,和显示值一样时没有)。各公司的节和指标不完全相同。

怎么调用 Yahoo Finance 机构持仓 API?

institutional_holdings

使用 platform="yahoo_finance"、action="institutional_holdings" 调用“机构持仓”能力;返回单个对象,主要包含 symbol、institutional_ownership_pct、shares_outstanding、holdings_value_usd、holders、shares_held 等 18 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Yahoo Finance institutional_holdings 的参数分别是什么意思?

keyword必填
要查机构持仓的美股代码,例如 NVDA(可带 $);不收公司名。返回机构持股比例、增减持统计和持仓最多的机构;代码查不到不扣费。

Yahoo Finance 官方帮助说明查到一只证券后可打开 Holders 标签页,内容是主要机构持有人和内部人持有人及涉及的持股数量。这里只核对「一个代码对应一页持股人信息」;该页不说明持股比例怎么算、名单来自哪类申报、多久更新,也不证明本接口的增减持统计口径。官方来源:Yahoo Finance:个股的 Holders 页来源核查:

Yahoo Finance 返回字段与含义(17)
symbol
股票代码。
institutional_ownership_pct
机构持股占总股本的百分比(institutional_holdings),76.59 表示 76.59%。
shares_outstanding
总股本,股数(institutional_holdings)。
holdings_value_usd
全部机构持仓的总市值,美元(institutional_holdings)。
holders
持有这只股票的机构数(institutional_holdings)。
shares_held
全部机构合计持股数(institutional_holdings)。
increased_holders
上一报告期增持的机构数(institutional_holdings);increased_shares 是它们合计增持的股数。
increased_shares
增持机构合计增持的股数(institutional_holdings)。
decreased_holders
上一报告期减持的机构数(institutional_holdings);decreased_shares 是它们合计减持的股数。
decreased_shares
减持机构合计减持的股数(institutional_holdings)。
unchanged_holders
持仓不变的机构数(institutional_holdings);unchanged_shares 是它们的合计持股。
unchanged_shares
持仓不变的机构合计持股数(institutional_holdings)。
new_holders
新建仓的机构数(institutional_holdings);new_shares 是新建仓的股数。
new_shares
新建仓的股数合计(institutional_holdings)。
sold_out_holders
清仓的机构数(institutional_holdings);sold_out_shares 是清仓的股数。
sold_out_shares
清仓的股数合计(institutional_holdings)。
top_holders
按持仓市值从大到小的机构(institutional_holdings):name、reported_at(持仓报告日期 YYYY-MM-DD)、shares(持股数)、change_shares(比上期变动股数,减持为负)、change_pct(变动百分比)、value_usd(持仓市值,美元)。
Yahoo Finance search 调用流程一次 Yahoo Finance search 调用的全过程:向 POST /api/v1/social 发送 platform="yahoo_finance"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、symbol、sector、industry 等字段;返回列表,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "yahoo_finance"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idnamesymbolsectorindustry
一次 Yahoo Finance search 调用的全过程:向 POST /api/v1/social 发送 platform="yahoo_finance"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、name、symbol、sector、industry 等字段;返回列表,计费 $1.39 / 千次,失败与空结果不计费。

Yahoo Finance 原始字段名

EveryInfra 统一字段名

左边是 Yahoo Finance 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Yahoo Finance 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 53 个字段名只在 Yahoo Finance 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • sector
  • market_cap
  • quote_type
  • exchange
  • pe_ratio
  • dividend_yield
  • open
  • high
  • low
  • close
  • dividends
  • stock_splits
  • income
  • balance_sheet
  • cash_flow
  • quarterly_income
  • recommendation_trend
  • upgrades_downgrades

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
symbol
股票代码。
sector
所属板块。
industry
所属行业。
market_cap
市值。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
quote_type
标的类型(股票 / ETF / 指数 / 加密货币等)。
exchange
所属交易所。
pe_ratio
市盈率。
dividend_yield
股息率。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
date
该条数据的日期。
open
开盘价。
high
最高价。
low
最低价。
close
收盘价。
volume
成交量。
dividends
分红记录。
stock_splits
拆股记录。
income
利润表。
balance_sheet
资产负债表。
cash_flow
现金流量表。
quarterly_income
季度利润表。
url
该记录在原平台上的可访问链接。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
publisher
资讯发布方。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
recommendation_trend
分析师评级分布随时间的变化。
upgrades_downgrades
评级调整历史。
contract_symbol
期权合约代码。
strike
行权价。
last_price
最新价。
bid
买一价。
ask
卖一价。
open_interest
未平仓合约数。
implied_volatility
隐含波动率。
in_the_money
是否为价内期权。
expiration
到期日。
expiration_dates
全部到期日。
strikes
全部行权价档位。
calls
看涨期权列表。
puts
看跌期权列表。
change
涨跌额。
change_percent
涨跌幅,百分数。
fifty_two_week_range
52 周价格区间。
quarters
按季度的每股收益(earnings):period(财季,如 Sep 2026)、status(reported 已公布 / upcoming 待公布)、eps_estimate(分析师一致预期)、eps_actual(实际,待公布季度没有)、eps_surprise(实际减预期)。
next_earnings_date
下次财报公布日期(earnings,YYYY-MM-DD,预计日期);公司没公布时没有。
next_earnings_timing
下次财报在盘前还是盘后公布(earnings):before_market_open / after_market_close;没说明时没有。
analyst_count
给出下季度 EPS 一致预期的分析师人数(earnings);没有时没有。
sections
统计指标分节(statistics):section(valuation、ratios、shares、margins、dividends 等)、summary(一句话概述)、items(key、label 指标名、value 显示值如 4.94T、raw_value 原始数值文本,和显示值一样时没有)。各公司的节和指标不完全相同。
institutional_ownership_pct
机构持股占总股本的百分比(institutional_holdings),76.59 表示 76.59%。
shares_outstanding
总股本,股数(institutional_holdings)。
holdings_value_usd
全部机构持仓的总市值,美元(institutional_holdings)。
holders
持有这只股票的机构数(institutional_holdings)。
shares_held
全部机构合计持股数(institutional_holdings)。
increased_holders
上一报告期增持的机构数(institutional_holdings);increased_shares 是它们合计增持的股数。
increased_shares
增持机构合计增持的股数(institutional_holdings)。
decreased_holders
上一报告期减持的机构数(institutional_holdings);decreased_shares 是它们合计减持的股数。
decreased_shares
减持机构合计减持的股数(institutional_holdings)。
unchanged_holders
持仓不变的机构数(institutional_holdings);unchanged_shares 是它们的合计持股。
unchanged_shares
持仓不变的机构合计持股数(institutional_holdings)。
new_holders
新建仓的机构数(institutional_holdings);new_shares 是新建仓的股数。
new_shares
新建仓的股数合计(institutional_holdings)。
sold_out_holders
清仓的机构数(institutional_holdings);sold_out_shares 是清仓的股数。
sold_out_shares
清仓的股数合计(institutional_holdings)。
top_holders
按持仓市值从大到小的机构(institutional_holdings):name、reported_at(持仓报告日期 YYYY-MM-DD)、shares(持股数)、change_shares(比上期变动股数,减持为负)、change_pct(变动百分比)、value_usd(持仓市值,美元)。

请求填写示例

keyword 是标的代码,不是公司名称全文搜索;仅示意输入,不是投资建议。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

yahoo_finance_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"yahoo_finance","action":"search","params":{"keyword":"AAPL"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "name": null,
  "symbol": null,
  "sector": null,
  "industry": null,
  "market_cap": null,
  "price": null,
  "currency": null,
  "quote_type": null,
  "exchange": null,
  "pe_ratio": null,
  "dividend_yield": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

怎样按 Yahoo Finance 标的代码核对行情与交易所?

search 实际是代码行情查询:keyword 填 AAPL 这类标的代码,并保留非美国市场的交易所后缀,不是公司名全文搜索。

查看 search 的 tickers 参数
  • tickers 为代码数组,存在时覆盖 keyword 的单标的输入;只有 search 使用该数组,不能把它套到其他 action。核对 symbol、exchange、quote_type 后再比较 price 与 currency。
  • market_cap、pe_ratio 与 dividend_yield 是不同指标,缺值不等于零;股息率如何缩放未在此响应中标明。当前没有报价时间或延迟字段,不能承诺实时、可成交价格或把数据当投资建议。

怎样区分 Yahoo 历史行情的回看跨度与 K 线粒度?

history 针对一个 keyword 标的,用 period 决定回看跨度、interval 决定每根 K 线的粒度。

查看 history 的 interval 参数
  • 当前默认 period=1mo、interval=1d;interval 中 1m 表示一分钟,1mo 才是一个月。分钟粒度与长跨度可能受历史窗口限制;目录未发布 allowedValues,不能把说明示例当作经过验证的任意组合。
  • open、high、low、close、volume 是单根 K 线,dividends 与 stock_splits 是公司行动字段。period 与 interval 覆盖的 K 线全部返回;没有 adjusted_close、复权标记、币种或交易时区,不能断言 close 已复权、覆盖完整交易日历或支持准确总回报回测。

怎样按公司标的读取三张财务报表?

financials 以单个 keyword 标的返回利润表、资产负债表、现金流量表和可能存在的季度利润表。

查看 financials 的 keyword 参数
  • keyword 使用完整标的代码,不是财报文件 URL;since、until 当前映射到图表日期,而本 action 已关闭图表,不能据此承诺选择财报报告期或会计年度。
  • income、balance_sheet、cash_flow、quarterly_income 是不同报表数组,页面给出几期就返回几期;科目随公司变化。币种、金额倍率、报告期和会计准则须逐行核实,不能预设 USD、千元或年度数据,也不是财报披露日历。

怎样把 Yahoo 标的新闻摘要关联回原始报道?

news 用单一 keyword 标的读取相关新闻,保留标题、发布方和链接,方便继续核实事件上下文。

查看 news 的 keyword 参数
  • 这不是全网新闻关键词搜索;since、until 不能据共享参数推断为新闻发布日期筛选。不同市场代码与同名公司的新闻应按返回 symbol 再确认关联。
  • text 来自新闻描述,不是整篇报道;text、title 都不截断,新闻条目全部返回。publisher 与 url 用于来源核验,posted_at 可能沿用原日期格式,不能把新闻出现时间当交易信号。

怎样分开看分析师评级分布与单次评级调整?

analyst 针对一个 keyword 标的返回评级分布及机构升降级记录,区分群体分布和单次意见变化。

查看 analyst 的 keyword 参数
  • recommendation_trend 是分布数组,upgrades_downgrades 才包含 firm、from_grade、to_grade、action 与目标价变动;嵌套字段不是每个响应的顶层字段。since、until 不是这两组数据的日期过滤器。
  • 评级分布与调整历史按页面给出的全部条目返回。price_target 与 prior_price_target 是机构意见,不是未来成交价;缺少目标价币种、有效期及完整覆盖保证,不将评级转成买卖建议。

怎样区分期权合约报价、行权价与未平仓量?

使用 keyword 作为基础标的读取看涨和看跌期权链,并使用 contract_symbol、strike 和 expiration 区分合约。

查看 options 的 keyword 参数
  • keyword 指基础标的,不是合约代码输入;当前没有指定到期日参数,since、until 也不是到期日过滤器。若响应以多条链组织,当前只从第一条链提取 calls、puts,不能称作所有期限链。
  • calls、puts、expiration_dates 与 strikes 都按返回的全部条目给出,不截断。last_price 是最近成交记录,与 bid、ask 不同;volume 与 open_interest 不同。缺少报价时间、乘数及明确币种,不能据此承诺实时成交成本,或计算缺乏明确基准的风险收益。

怎样读取 Yahoo 榜单并区分涨幅与成交活跃度?

trending 无需 keyword,以 screener 选择预设榜单,当前默认 DAY_GAINERS 表示当日涨幅榜。

查看 trending 的 screener 参数
  • screener 说明中还有 MOST_ACTIVES 等类别,但当前目录未提供 allowedValues,也没有完整枚举,不保证每类始终有数据。当天按目标市场交易日理解,不等于北京时间当天;没有开放金融事件日历 action。
  • change 为涨跌额,change_percent 为涨跌百分数,volume 为成交量;它们不是同一个排名依据。结合 exchange、currency 看 price,当前没有报价时间或会话标签,不能宣称全市场实时榜单或用热门程度推荐投资。

怎样按股票代码查近几个季度的每股收益和下次财报日?

用 earnings 输入一个美股代码,取回最近已公布季度的每股收益实际值与一致预期,以及往后几个季度的预期。

查看 earnings 的 keyword 参数
  • keyword 填美股代码,例如 AAPL、BRK.B、BF-B,大小写不分,前面带 $ 也可以;只支持在美国上市的标的。
  • quarters 每项有 period、status(reported 已公布或 upcoming 待公布)、eps_estimate、eps_actual 和 eps_surprise。next_earnings_date、next_earnings_timing(盘前或盘后)和 analyst_count 只在下次财报日已经公告后才有,通常是财报前约七周内。

怎样一次读取一只美股的估值、利润率和分红等统计指标?

用 statistics 输入一个美股代码,取回按主题分节的统计指标,覆盖估值、比率、股本、利润率、分红等方面。

查看 statistics 的 keyword 参数
  • keyword 填一个在美国上市的股票代码;代码不存在时请求会失败,不会返回空的统计表。
  • sections 每节有 section 名称、一句 summary 和若干 items;每项有 key、label、按页面显示的 value(如 4.94T),数值换算有差别时另给 raw_value。不同公司的分节和条目数不一样。

怎样看一只美股的机构持股比例和增减持变化?

用 institutional_holdings 输入一个美股代码,取回机构持股比例、持仓市值、增减持家数和股数,以及持仓最大的机构名单。

查看 institutional_holdings 的 keyword 参数
  • keyword 只支持美国上市的代码。limit 只决定 top_holders 返回几家机构,默认 20、最多 100,其余汇总字段不受影响。
  • increased_、decreased_、unchanged_、new_、sold_out_ 开头的字段分别是增持、减持、不变、新进、清仓的机构家数(_holders)和股数(_shares)。holdings_value_usd 以美元计;top_holders 每项有机构名称、报告日期、持股数、变动股数与比例和市值。

Yahoo Finance API 常见问题

Yahoo Finance API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="yahoo_finance"、action 和 params。以 search 为例,必填 keyword,可选 tickers。keyword 是标的代码,不是公司名称全文搜索;仅示意输入,不是投资建议。 Yahoo Finance 共 10 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Yahoo Finance API 怎么收费?

每千次 $1.39 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 125 次 Yahoo Finance 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Yahoo Finance API 一次能返回多少条数据?

Yahoo Finance 有 4 个列表接口,包括 search、history、news、trending。其余 6 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Yahoo Finance API 返回哪些字段?

当前目录为 search 列出 id、name、symbol、sector、industry、market_cap 等 13 个字段名。按全站当前目录统计,53 个字段名只在 Yahoo Finance 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

怎样按 Yahoo Finance 标的代码核对行情与交易所?

search 实际是代码行情查询:keyword 填 AAPL 这类标的代码,并保留非美国市场的交易所后缀,不是公司名全文搜索。 tickers 为代码数组,存在时覆盖 keyword 的单标的输入;只有 search 使用该数组,不能把它套到其他 action。核对 symbol、exchange、quote_type 后再比较 price 与 currency。 market_cap、pe_ratio 与 dividend_yield 是不同指标,缺值不等于零;股息率如何缩放未在此响应中标明。当前没有报价时间或延迟字段,不能承诺实时、可成交价格或把数据当投资建议。

怎样区分 Yahoo 历史行情的回看跨度与 K 线粒度?

history 针对一个 keyword 标的,用 period 决定回看跨度、interval 决定每根 K 线的粒度。 当前默认 period=1mo、interval=1d;interval 中 1m 表示一分钟,1mo 才是一个月。分钟粒度与长跨度可能受历史窗口限制;目录未发布 allowedValues,不能把说明示例当作经过验证的任意组合。 open、high、low、close、volume 是单根 K 线,dividends 与 stock_splits 是公司行动字段。period 与 interval 覆盖的 K 线全部返回;没有 adjusted_close、复权标记、币种或交易时区,不能断言 close 已复权、覆盖完整交易日历或支持准确总回报回测。

怎样按公司标的读取三张财务报表?

financials 以单个 keyword 标的返回利润表、资产负债表、现金流量表和可能存在的季度利润表。 keyword 使用完整标的代码,不是财报文件 URL;since、until 当前映射到图表日期,而本 action 已关闭图表,不能据此承诺选择财报报告期或会计年度。 income、balance_sheet、cash_flow、quarterly_income 是不同报表数组,页面给出几期就返回几期;科目随公司变化。币种、金额倍率、报告期和会计准则须逐行核实,不能预设 USD、千元或年度数据,也不是财报披露日历。

怎样把 Yahoo 标的新闻摘要关联回原始报道?

news 用单一 keyword 标的读取相关新闻,保留标题、发布方和链接,方便继续核实事件上下文。 这不是全网新闻关键词搜索;since、until 不能据共享参数推断为新闻发布日期筛选。不同市场代码与同名公司的新闻应按返回 symbol 再确认关联。 text 来自新闻描述,不是整篇报道;text、title 都不截断,新闻条目全部返回。publisher 与 url 用于来源核验,posted_at 可能沿用原日期格式,不能把新闻出现时间当交易信号。

可以先免费试用 Yahoo Finance API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Yahoo Finance 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 10 个能力。无需信用卡。

开始调用 Yahoo Finance API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Yahoo Finance 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策