Yahoo Finance Data API

Get structured Yahoo Finance quotes, fundamentals, charts, news, options, and search results.

原始信息汇总

数据集概述

Yahoo Finance Data API 是一个基于 RapidAPI 平台的数据接口服务，旨在为开发者提供结构化的 Yahoo Finance 金融数据。该 API 通过六个独立的单目标端点，支持获取行情报价、基本面数据、图表、新闻、期权链及发现类数据。该服务适用于股票、ETF、指数、加密货币、货币对、期货和共同基金等多种金融工具（前提是 Yahoo Finance 有对应代码的数据）。

---

主要特性

• 多维数据支持：涵盖常规、盘前和盘后报价（如有）、公司或基金简介、估值与财务统计、日历事件、推荐与评级、分析师一致预期、内幕与机构持股数据。
• 图表与新闻：提供 OHLCV 图表序列及市场事件（如分红、拆股），并支持获取单只代码的 RSS 新闻。
• 期权链数据：支持获取最近的期权链、指定到期日或全部可选到期日的期权数据。
• 搜索与趋势：支持搜索金融工具或获取热门代码。
• 部分结果处理：在 Quote 和 Fundamentals 端点中，当某个数据源组请求失败时，仍保留其他组的有用数据，并在响应中明确返回 partial 和 failedSections 字段。

---

可用端点

端点	用途
POST /quote	获取单只代码的报价、简介、统计、推荐、见解、评级及事件数据。
POST /fundamentals	获取单只代码的财务报表、分析师数据和持股数据。
POST /chart	获取单只代码的图表元数据、OHLCV 序列和图表事件。
POST /news	获取单只代码的 RSS 新闻。
POST /options	获取单只代码的期权链。
POST /search	工具搜索或热门代码发现。

每个成功的请求返回 HTTP 201，并消耗一个 RapidAPI 请求配额单位，后端响应中 creditsUsed 为 0。

---

使用场景与限制

• 输入限制：每个 API 调用处理一个代码或一次发现请求；请求对象严格，未知属性将返回 HTTP 400；代码、查询和地区文本会被去除首尾空格，空白文本同样返回 HTTP 400。
• 字段选择：支持通过 fields 数组选择特定数据部分，字段名称严格、唯一且有上限；若使用 "*" 则必须作为唯一值。
• 时间限制：完整服务请求限时 55 秒，超时返回可重试的 HTTP 504；每个上游请求限时 15 秒。客户端断开连接时，若仍可响应，则返回非可重试的 HTTP 499。
• 来源固定：源语言固定为英语，市场数据固定为美国市场；Search 的 region 仅影响热门代码的请求路径，不影响其他数据。
• 错误处理：错误响应采用 application/problem+json 格式，包含 type、status、code、message、requestId、docUrl 和 retryable 字段。仅当 retryable 为 true 时应考虑重试，并使用退避策略。

---

数据与合规提示

• 该 API 基于 Yahoo Finance 的私人 Web 接口和 RSS 源，并非经文档化的 Yahoo 商业 API，因此源数据可能存在延迟、不完整、变更或不可用的情况。
• Yahoo、交易所、新闻出版商、分析师提供商及其他数据所有者可能对数据的使用、许可证、归属、延迟、地域、存储和再分发规则施加限制。在商业使用或转售前，应审查相关条款和条件。此提示为操作警告，并非技术发布门槛。
• 价格时效和交易所延迟因工具和市场而异，不应假设所有值均为实时数据。