全网搜索 · 数据 API

Yahoo Finance

Yahoo Finance API

按标的代码读取 Yahoo Finance 行情、历史价格、财务报表、分析师评级、期权及相关新闻,区分市场记录与机构意见,为研究提供数据,不构成投资建议。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

7

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Yahoo Finance 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordtickers—同步$1.39 / 千次id · name · symbol · sector · industry · market_cap · price · currency · quote_type · exchange · pe_ratio · dividend_yield · platform
historykeywordinterval, period—同步$1.39 / 千次symbol · date · open · high · low · close · volume · dividends · stock_splits · platform
financialskeyword——同步$1.39 / 千次symbol · income · balance_sheet · cash_flow · quarterly_income · platform
newskeyword——同步$1.39 / 千次id · url · title · text · publisher · posted_at · symbol · platform
analystkeyword——同步$1.39 / 千次symbol · recommendation_trend · upgrades_downgrades · platform
optionskeyword——同步$1.39 / 千次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 · 最多 200同步$1.39 / 千次id · symbol · name · price · change · change_percent · volume · market_cap · currency · exchange · pe_ratio · fifty_two_week_range · platform

Yahoo Finance 每个接口分别做什么

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

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

怎么调用 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 定位标的是自身请求契约;该来源不证明新闻完整性、排序、授权再分发或固定时间范围。官方来源: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 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 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

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

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

  • symbol
  • 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

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/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 周价格区间。

请求填写示例

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

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

yahoo_finance_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的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 是公司行动字段。当前最多保留 2000 根且没有 adjusted_close、复权标记、币种或交易时区,不能断言 close 已复权、覆盖完整交易日历或支持准确总回报回测。

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

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

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

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

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

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

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

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

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

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

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

查看 options 的 keyword 参数 →
  • keyword 指基础标的,不是合约代码输入;当前没有指定到期日参数,since、until 也不是到期日过滤器。若响应以多条链组织,当前只从第一条链提取 calls、puts,不能称作所有期限链。
  • calls、puts 各最多 200 条;expiration_dates 最多 40 项、strikes 最多 200 项。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,当前没有报价时间或会话标签,不能宣称全市场实时榜单或用热门程度推荐投资。

Yahoo Finance API 常见问题

Yahoo Finance API 怎么调用?

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

Yahoo Finance API 怎么收费?

$1.39 / 千次,Yahoo Finance 全部 7 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Yahoo Finance 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

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

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

Yahoo Finance API 返回哪些字段?

当前目录为 search 列出 id、name、symbol、sector、industry、market_cap 等 13 个字段名。按全站当前目录统计,35 个字段名只在 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 是公司行动字段。当前最多保留 2000 根且没有 adjusted_close、复权标记、币种或交易时区,不能断言 close 已复权、覆盖完整交易日历或支持准确总回报回测。

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

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

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

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

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

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Yahoo Finance 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 7 个能力。无需信用卡。

开始调用 Yahoo Finance API

加微信领 $1 免费额度,先选一个 Yahoo Finance 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始