> Source: https://ashareapi.com/us-stock/ · Markdown version for LLMs / AI agents 美股数据 # 美股数据：从三大指数，到单只的机构评级 美股研究通常从指数环境开始（道指 / 纳指 / 标普500），再看单只的财务与机构态度，最后看空头——跌的时候，卖空比率比市盈率更能说明问题。这 16 个入口覆盖这条链。 一句话说清 **美股数据 = 指数环境（三大指数）＋ 单只基本面（财务/分红/简况）＋ 机构态度（评级/目标价）＋ 空头（卖空比率）**。⚠️ 美股**没有**股东明细、事件日历、回购、一致预期、个股资金流 —— 这些是数据覆盖边界，不是接口没做好。 ## 按你要回答的问题选入口 美股能查的 16 个入口，最常用的是这四类： | | | 你要回答的问题 | 入口 | 拿到什么 | | 「大盘现在什么位置？」 | [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) | 道指 `usDJI` 52,867.98 · 纳指 `usIXIC` 26,008.86 · 标普500 `usINX` 7,663.43（⚠️ 指数只有 day 线） | | 「这家公司怎么样？」 | [/v1/finance](/docs/endpoints/finance) · [/v1/dividend](/docs/endpoints/dividend) · [/v1/profile](/docs/endpoints/profile) | 财务三表、分红派息、公司简况 | | 「机构怎么看？」 | [/v1/rating](/docs/endpoints/rating) · [/v1/consensus](/docs/endpoints/consensus) ⛔ | 目标价均值/最高/最低 + 评级分布 + 覆盖机构数（实测 `usAAPL` 17 行） | | 「空头在做什么？」 | [/v1/fund-short](/docs/endpoints/fund-short) | 卖空比率、回补天数、卖空股数（实测 `usAAPL`：0.83%、2.82 天、1.21 亿股） 「大盘现在什么位置？」 [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) 道指 `usDJI` 52,867.98 · 纳指 `usIXIC` 26,008.86 · 标普500 `usINX` 7,663.43（⚠️ 指数只有 day 线） 「这家公司怎么样？」 [/v1/finance](/docs/endpoints/finance) · [/v1/dividend](/docs/endpoints/dividend) · [/v1/profile](/docs/endpoints/profile) 财务三表、分红派息、公司简况 「机构怎么看？」 [/v1/rating](/docs/endpoints/rating) · [/v1/consensus](/docs/endpoints/consensus) ⛔ 目标价均值/最高/最低 + 评级分布 + 覆盖机构数（实测 `usAAPL` 17 行） 「空头在做什么？」 [/v1/fund-short](/docs/endpoints/fund-short) 卖空比率、回补天数、卖空股数（实测 `usAAPL`：0.83%、2.82 天、1.21 亿股） ⇒ 还有：[/v1/minute](/docs/endpoints/minute) 分时 · [/v1/technical](/docs/endpoints/technical) 55 项技术指标 · [/v1/ipo](/docs/endpoints/ipo) 新股 · [/v1/search](/docs/endpoints/search) 搜索 · [/v1/news](/docs/endpoints/news) 新闻 · [/v1/notice](/docs/endpoints/notice) 公告 · [/v1/disclosure](/docs/endpoints/disclosure) 财报披露日 · [/v1/suspension](/docs/endpoints/suspension) 停复牌 · `/v1/screen?market=us` 美股选股。 ## 16 个入口（按用途） 美股可用端点一览： | | | 用途 | 端点 | 要点 | | 指数 / 行情 | [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) | 道指 `usDJI` · 纳指 `usIXIC` · 标普500 **usINX**（⚠️ 不是 `usSPX`）；指数仅 day | | 技术与分时 | [/v1/technical](/docs/endpoints/technical) · [/v1/minute](/docs/endpoints/minute) | 55 项指标；分时窗口比 A 股短 | | 基本面 | [/v1/finance](/docs/endpoints/finance) · [/v1/dividend](/docs/endpoints/dividend) · [/v1/profile](/docs/endpoints/profile) | 实测 AAPL：财务 6 行 / 分红 5 行 / 简况 2 行 | | 机构态度 | [/v1/rating](/docs/endpoints/rating) | 目标价 + 评级分布 + 月度趋势（实测 17 行） | | 卖空 | [/v1/fund-short](/docs/endpoints/fund-short) | ⚠️ **必须传 date**，否则只回标识字段 | | 事件 | [/v1/disclosure](/docs/endpoints/disclosure) · [/v1/suspension](/docs/endpoints/suspension) · [/v1/ipo](/docs/endpoints/ipo) | 披露日 / 停牌清单（实测美股 90 条）/ 新股 | | 筛选 | `/v1/screen?market=us` | ⚠️ 表达式必须用 `PeTTM`（写 `PE_TTM` 会报错） | | 资讯 / 工具 | [/v1/news](/docs/endpoints/news) · [/v1/notice](/docs/endpoints/notice) · [/v1/search](/docs/endpoints/search) | 代码格式 `usAAPL`（大写字母） 指数 / 行情 [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) 道指 `usDJI` · 纳指 `usIXIC` · 标普500 **usINX**（⚠️ 不是 `usSPX`）；指数仅 day 技术与分时 [/v1/technical](/docs/endpoints/technical) · [/v1/minute](/docs/endpoints/minute) 55 项指标；分时窗口比 A 股短 基本面 [/v1/finance](/docs/endpoints/finance) · [/v1/dividend](/docs/endpoints/dividend) · [/v1/profile](/docs/endpoints/profile) 实测 AAPL：财务 6 行 / 分红 5 行 / 简况 2 行 机构态度 [/v1/rating](/docs/endpoints/rating) 目标价 + 评级分布 + 月度趋势（实测 17 行） 卖空 [/v1/fund-short](/docs/endpoints/fund-short) ⚠️ **必须传 date**，否则只回标识字段 事件 [/v1/disclosure](/docs/endpoints/disclosure) · [/v1/suspension](/docs/endpoints/suspension) · [/v1/ipo](/docs/endpoints/ipo) 披露日 / 停牌清单（实测美股 90 条）/ 新股 筛选 `/v1/screen?market=us` ⚠️ 表达式必须用 `PeTTM`（写 `PE_TTM` 会报错） 资讯 / 工具 [/v1/news](/docs/endpoints/news) · [/v1/notice](/docs/endpoints/notice) · [/v1/search](/docs/endpoints/search) 代码格式 `usAAPL`（大写字母） ## 五条能直接跑的例子 [/v1/quote](/docs/endpoints/quote)、[/v1/kline](/docs/endpoints/kline) 免费无需 Key；财务、评级、卖空需付费档。美股代码是 **us + 大写字母**：`usAAPL`。 ``` # ① 三大指数现价（道指 / 纳指 / 标普500） curl "https://api.ashareapi.com/v1/quote?code=usDJI,usIXIC,usINX" # ② 标普 500 日线（⚠️ 指数只有 day） curl "https://api.ashareapi.com/v1/kline?code=usINX&period=day&count=20" # ③ 机构评级：目标价与评级分布 curl "https://api.ashareapi.com/v1/rating?codes=usAAPL&key=$KEY" # ④ 卖空数据（⚠️ 必须传 date） curl "https://api.ashareapi.com/v1/fund-short?code=usAAPL&date=2026-09-30&key=$KEY" # ⑤ 美股选股（⚠️ 字段用 PeTTM） curl "https://api.ashareapi.com/v1/screen?market=us&mode=condition&expr=intersect([PeTTM > 0])&key=$KEY" ``` ⚠️ 两个最常见的坑：① 标普 500 是 **usINX**（不是 `usSPX`）；② 美股选股的 PE 字段是 **PeTTM**（大小写敏感，写成 `PE_TTM` 会失败）。 ## Agent 拿这一页就能用 接成 MCP 工具后，Agent 可以直接答这些问题： | | | 用户这么问 | Agent 该调 | 要点 | | 「道指 / 纳指 / 标普现在多少」 | `ashare_quote(code="usDJI,usIXIC,usINX")` | 标普是 `usINX`，不是 usSPX | | 「苹果的机构目标价」 | `ashare_rating(codes="usAAPL")` | 目标价在 `targetPriceAvg` | | 「苹果被做空多少」 | `ashare_fund_short(code="usAAPL", date="2026-09-30")` | ⚠️ 不传 date 只回标识字段 | | 「苹果的财报」 | `ashare_finance(code="usAAPL")` | 字段口径与 A 股不同 | | 「什么时候出财报」 | `ashare_disclosure(codes="usAAPL")` | 披露日 | | 「筛低 PE 的美股」 | `ashare_screen(market="us", expr="intersect([PeTTM > 0])")` | ⚠️ 必须 `PeTTM` 「道指 / 纳指 / 标普现在多少」 `ashare_quote(code="usDJI,usIXIC,usINX")` 标普是 `usINX`，不是 usSPX 「苹果的机构目标价」 `ashare_rating(codes="usAAPL")` 目标价在 `targetPriceAvg` 「苹果被做空多少」 `ashare_fund_short(code="usAAPL", date="2026-09-30")` ⚠️ 不传 date 只回标识字段 「苹果的财报」 `ashare_finance(code="usAAPL")` 字段口径与 A 股不同 「什么时候出财报」 `ashare_disclosure(codes="usAAPL")` 披露日 「筛低 PE 的美股」 `ashare_screen(market="us", expr="intersect([PeTTM > 0])")` ⚠️ 必须 `PeTTM` ⚠️ **Agent 的三条纪律**：① 美股代码 `us` + 大写字母（`usAAPL`）；② [/v1/search](/docs/endpoints/search) 可先确认代码；③ **美股没有股东/事件日历/回购/一致预期/个股资金流** —— 别去调那些端点，会空。 ## 边界先说清（6 条，省你试错） 美股的数据覆盖比 A 股窄，这些是边界不是 bug： 没有股东明细 [/v1/shareholder](/docs/endpoints/shareholder) 只覆盖 A 股与港股 —— 美股查不到十大股东、机构持仓。 没有事件日历 [/v1/calendar](/docs/endpoints/calendar)（分红/解禁/会议排期）只有 A 股与港股；美股用 `disclosure` 看财报日。 没有回购、一致预期 [/v1/buyback](/docs/endpoints/buyback)、[/v1/consensus](/docs/endpoints/consensus) 只覆盖 A 股与港股。美股的目标价与预测请用 [/v1/rating](/docs/endpoints/rating)。 没有个股资金流 [/v1/fund-flow](/docs/endpoints/fund-flow) 只有 A 股与港股。美股资金面目前只有**卖空**一条腿（[/v1/fund-short](/docs/endpoints/fund-short)）。 没有美股指数成分 [/v1/index-constituent](/docs/endpoints/index-constituent) 只覆盖 A 股指数与港股指数（恒指/国企/恒科）；美股没有标普成分清单。 美股 K 线不提供日期范围 只能用 `count` 取最近 N 条（日线）—— 与港股同一限制。 ## 常见问题 美股代码怎么写？ **us + 大写字母**：苹果 `usAAPL`、特斯拉 `usTSLA`。与港股 5 位数字（`hk00700`）、A 股 6 位（`sh600519`）都不同。不确定先 [/v1/search](/docs/endpoints/search)。 标普 500 为什么查不到？ 代码不是 `usSPX`，而是 **usINX**（实测 7,663.43）。`usSPX` / `usGSPC` / `usSPX500` 都查不到。 美股能查资金流吗？ **只有卖空**（[/v1/fund-short](/docs/endpoints/fund-short)：卖空比率、回补天数、卖空股数）。没有主力/散户资金流。 美股能用因子选股吗？ 能。`/v1/screen?market=us` 已实测可用，但表达式字段是 **PeTTM**（不是 `PE_TTM`），是大小写敏感的。 免费能查美股吗？ [/v1/quote](/docs/endpoints/quote)、[/v1/kline](/docs/endpoints/kline) 免费（含三大指数）；财务、评级、卖空、选股需标准版（¥29.9）或专业版（¥99）。 ## 想再深入 相关文档： [美股能力盘点（16 个入口全表 + 实测） 14 命令级 + 卖空 + 选股 · 比港股少的 7 项 · 实测数字](/docs)[行情端点（含三大指数） 美股指数代码 usDJI / usIXIC / usINX](/docs/endpoints/quote)[卖空端点 港美股卖空 · 必须传 date](/docs/endpoints/fund-short) 用三大指数试一下 [/v1/quote](/docs/endpoints/quote) 与 [/v1/kline](/docs/endpoints/kline) 免费无需 Key，直接查道指纳指标普。 [MCP 接入说明](/mcp)[查看定价](/pricing)