美股数据：从三大指数，到单只的机构评级
美股研究通常从指数环境开始（道指 / 纳指 / 标普500），再看单只的财务与机构态度，最后看空头——跌的时候，卖空比率比市盈率更能说明问题。这 16 个入口覆盖这条链。
美股数据 = 指数环境（三大指数）＋ 单只基本面（财务/分红/简况）＋ 机构态度（评级/目标价）＋ 空头（卖空比率）。⚠️ 美股没有股东明细、事件日历、回购、一致预期、个股资金流 —— 这些是数据覆盖边界，不是接口没做好。
按你要回答的问题选入口
美股能查的 16 个入口，最常用的是这四类：
| 你要回答的问题 | 入口 | 拿到什么 |
|---|---|---|
| 「大盘现在什么位置？」 | /v1/quote · /v1/kline | 道指 usDJI 52,867.98 · 纳指 usIXIC 26,008.86 · 标普500 usINX 7,663.43（⚠️ 指数只有 day 线） |
| 「这家公司怎么样？」 | /v1/finance · /v1/dividend · /v1/profile | 财务三表、分红派息、公司简况 |
| 「机构怎么看？」 | /v1/rating · /v1/consensus ⛔ | 目标价均值/最高/最低 + 评级分布 + 覆盖机构数（实测 usAAPL 17 行） |
| 「空头在做什么？」 | /v1/fund-short | 卖空比率、回补天数、卖空股数（实测 usAAPL：0.83%、2.82 天、1.21 亿股） |
usDJI 52,867.98 · 纳指 usIXIC 26,008.86 · 标普500 usINX 7,663.43（⚠️ 指数只有 day 线）⇒ 还有：/v1/minute 分时 · /v1/technical 55 项技术指标 · /v1/ipo 新股 · /v1/search 搜索 · /v1/news 新闻 · /v1/notice 公告 · /v1/disclosure 财报披露日 · /v1/suspension 停复牌 · /v1/screen?market=us 美股选股。
16 个入口（按用途）
美股可用端点一览：
| 用途 | 端点 | 要点 |
|---|---|---|
| 指数 / 行情 | /v1/quote · /v1/kline | 道指 usDJI · 纳指 usIXIC · 标普500 usINX（⚠️ 不是 usSPX）；指数仅 day |
| 技术与分时 | /v1/technical · /v1/minute | 55 项指标；分时窗口比 A 股短 |
| 基本面 | /v1/finance · /v1/dividend · /v1/profile | 实测 AAPL：财务 6 行 / 分红 5 行 / 简况 2 行 |
| 机构态度 | /v1/rating | 目标价 + 评级分布 + 月度趋势（实测 17 行） |
| 卖空 | /v1/fund-short | ⚠️ 必须传 date，否则只回标识字段 |
| 事件 | /v1/disclosure · /v1/suspension · /v1/ipo | 披露日 / 停牌清单（实测美股 90 条）/ 新股 |
| 筛选 | /v1/screen?market=us | ⚠️ 表达式必须用 PeTTM（写 PE_TTM 会报错） |
| 资讯 / 工具 | /v1/news · /v1/notice · /v1/search | 代码格式 usAAPL（大写字母） |
/v1/screen?market=usPeTTM（写 PE_TTM 会报错）五条能直接跑的例子
/v1/quote、/v1/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，不是 usSPXashare_rating(codes="usAAPL")targetPriceAvgashare_fund_short(code="usAAPL", date="2026-09-30")ashare_finance(code="usAAPL")ashare_disclosure(codes="usAAPL")ashare_screen(market="us", expr="intersect([PeTTM > 0])")PeTTM⚠️ Agent 的三条纪律：① 美股代码 us + 大写字母（usAAPL）；② /v1/search 可先确认代码；③ 美股没有股东/事件日历/回购/一致预期/个股资金流 —— 别去调那些端点，会空。
边界先说清（6 条，省你试错）
美股的数据覆盖比 A 股窄，这些是边界不是 bug：
/v1/shareholder 只覆盖 A 股与港股 —— 美股查不到十大股东、机构持仓。
/v1/calendar（分红/解禁/会议排期）只有 A 股与港股；美股用 disclosure 看财报日。
/v1/buyback、/v1/consensus 只覆盖 A 股与港股。美股的目标价与预测请用 /v1/rating。
/v1/fund-flow 只有 A 股与港股。美股资金面目前只有卖空一条腿（/v1/fund-short）。
/v1/index-constituent 只覆盖 A 股指数与港股指数（恒指/国企/恒科）；美股没有标普成分清单。
只能用 count 取最近 N 条（日线）—— 与港股同一限制。
常见问题
us + 大写字母：苹果 usAAPL、特斯拉 usTSLA。与港股 5 位数字（hk00700）、A 股 6 位（sh600519）都不同。不确定先 /v1/search。
代码不是 usSPX，而是 usINX（实测 7,663.43）。usSPX / usGSPC / usSPX500 都查不到。
只有卖空（/v1/fund-short：卖空比率、回补天数、卖空股数）。没有主力/散户资金流。
能。/v1/screen?market=us 已实测可用，但表达式字段是 PeTTM（不是 PE_TTM），是大小写敏感的。