> Source: https://ashareapi.com/en/us-stock/ · Markdown version for LLMs / AI agents US stock data # US stock data: from the three indices down to one ticker US research usually starts with the index backdrop (Dow / NASDAQ / S&P 500), then moves to the financials of one name and what analysts think, and finally to the short side — when prices fall, the short ratio says more than the P/E. These 16 entry points cover that chain. In one sentence **US data = index backdrop (three indices) + per-stock fundamentals (financials / dividends / profile) + analyst view (ratings / target price) + short side (short ratio)**. ⚠️ The US does **not** have shareholder detail, an events calendar, buybacks, consensus estimates, or per-stock money flow — those are coverage limits, not broken endpoints. ## Pick the entry point by the question Sixteen entries are available; these four cover the common cases: | | | Your question | Entry point | What you get | | "Where is the market?" | [/v1/quote](/en/docs/endpoints/quote) · [/v1/kline](/en/docs/endpoints/kline) | Dow `usDJI` 52,867.98 · NASDAQ `usIXIC` 26,008.86 · S&P 500 `usINX` 7,663.43 (⚠️ indices are daily only) | | "How is this company doing?" | [/v1/finance](/en/docs/endpoints/finance) · [/v1/dividend](/en/docs/endpoints/dividend) · [/v1/profile](/en/docs/endpoints/profile) | Financial statements, dividends, company profile | | "What do analysts think?" | [/v1/rating](/docs/endpoints/rating) | Average / max / min target price + rating distribution + analyst count (measured 17 rows for `usAAPL`) | | "What is the short side doing?" | [/v1/fund-short](/docs/endpoints/fund-short) | Short ratio, days to cover, shares shorted (measured `usAAPL`: 0.83% / 2.82 days / 121m shares) "Where is the market?" [/v1/quote](/en/docs/endpoints/quote) · [/v1/kline](/en/docs/endpoints/kline) Dow `usDJI` 52,867.98 · NASDAQ `usIXIC` 26,008.86 · S&P 500 `usINX` 7,663.43 (⚠️ indices are daily only) "How is this company doing?" [/v1/finance](/en/docs/endpoints/finance) · [/v1/dividend](/en/docs/endpoints/dividend) · [/v1/profile](/en/docs/endpoints/profile) Financial statements, dividends, company profile "What do analysts think?" [/v1/rating](/docs/endpoints/rating) Average / max / min target price + rating distribution + analyst count (measured 17 rows for `usAAPL`) "What is the short side doing?" [/v1/fund-short](/docs/endpoints/fund-short) Short ratio, days to cover, shares shorted (measured `usAAPL`: 0.83% / 2.82 days / 121m shares) ⇒ Also: [/v1/minute](/en/docs/endpoints/minute) · [/v1/technical](/en/docs/endpoints/technical) (55 indicators) · [/v1/ipo](/en/docs/endpoints/ipo) · [/v1/search](/en/docs/endpoints/search) · [/v1/news](/en/docs/endpoints/news) · [/v1/notice](/en/docs/endpoints/notice) · [/v1/disclosure](/docs/endpoints/disclosure) · [/v1/suspension](/docs/endpoints/suspension) · `/v1/screen?market=us`. ## 16 entry points by purpose US-capable endpoints: | | | Purpose | Endpoints | Notes | | Indices / quotes | [/v1/quote](/en/docs/endpoints/quote) · [/v1/kline](/en/docs/endpoints/kline) | Dow `usDJI` · NASDAQ `usIXIC` · S&P 500 **usINX** (⚠️ not `usSPX`); indices are daily only | | Technicals / intraday | [/v1/technical](/en/docs/endpoints/technical) · [/v1/minute](/en/docs/endpoints/minute) | 55 indicators; intraday window is shorter than A-shares | | Fundamentals | [/v1/finance](/en/docs/endpoints/finance) · [/v1/dividend](/en/docs/endpoints/dividend) · [/v1/profile](/en/docs/endpoints/profile) | Measured AAPL: 6 / 5 / 2 rows | | Analyst view | [/v1/rating](/docs/endpoints/rating) | Target price + rating distribution + monthly trend (17 rows measured) | | Short side | [/v1/fund-short](/docs/endpoints/fund-short) | ⚠️ **date is required**, otherwise only identifier fields | | Events | [/v1/disclosure](/docs/endpoints/disclosure) · [/v1/suspension](/docs/endpoints/suspension) · [/v1/ipo](/en/docs/endpoints/ipo) | Earnings dates / halted list (90 rows for US) / IPOs | | Screening | `/v1/screen?market=us` | ⚠️ Expression must use `PeTTM` (`PE_TTM` fails) | | News / utility | [/v1/news](/en/docs/endpoints/news) · [/v1/notice](/en/docs/endpoints/notice) · [/v1/search](/en/docs/endpoints/search) | Code format `usAAPL` (uppercase) Indices / quotes [/v1/quote](/en/docs/endpoints/quote) · [/v1/kline](/en/docs/endpoints/kline) Dow `usDJI` · NASDAQ `usIXIC` · S&P 500 **usINX** (⚠️ not `usSPX`); indices are daily only Technicals / intraday [/v1/technical](/en/docs/endpoints/technical) · [/v1/minute](/en/docs/endpoints/minute) 55 indicators; intraday window is shorter than A-shares Fundamentals [/v1/finance](/en/docs/endpoints/finance) · [/v1/dividend](/en/docs/endpoints/dividend) · [/v1/profile](/en/docs/endpoints/profile) Measured AAPL: 6 / 5 / 2 rows Analyst view [/v1/rating](/docs/endpoints/rating) Target price + rating distribution + monthly trend (17 rows measured) Short side [/v1/fund-short](/docs/endpoints/fund-short) ⚠️ **date is required**, otherwise only identifier fields Events [/v1/disclosure](/docs/endpoints/disclosure) · [/v1/suspension](/docs/endpoints/suspension) · [/v1/ipo](/en/docs/endpoints/ipo) Earnings dates / halted list (90 rows for US) / IPOs Screening `/v1/screen?market=us` ⚠️ Expression must use `PeTTM` (`PE_TTM` fails) News / utility [/v1/news](/en/docs/endpoints/news) · [/v1/notice](/en/docs/endpoints/notice) · [/v1/search](/en/docs/endpoints/search) Code format `usAAPL` (uppercase) ## Five examples you can run now [/v1/quote](/en/docs/endpoints/quote) and [/v1/kline](/en/docs/endpoints/kline) are free without a key; financials, ratings and short data need a paid tier. US codes are **us + uppercase**: `usAAPL`. ``` # 1) Three indices curl "https://api.ashareapi.com/v1/quote?code=usDJI,usIXIC,usINX" # 2) S&P 500 daily bars (⚠️ indices are daily only) curl "https://api.ashareapi.com/v1/kline?code=usINX&period=day&count=20" # 3) Analyst ratings curl "https://api.ashareapi.com/v1/rating?codes=usAAPL&key=$KEY" # 4) Short selling (⚠️ date required) curl "https://api.ashareapi.com/v1/fund-short?code=usAAPL&date=2026-09-30&key=$KEY" # 5) Screening (⚠️ use PeTTM) curl "https://api.ashareapi.com/v1/screen?market=us&mode=condition&expr=intersect([PeTTM > 0])&key=$KEY" ``` ⚠️ Two traps: (1) the S&P 500 code is **usINX** (not `usSPX`); (2) US screening uses **PeTTM** (case-sensitive — `PE_TTM` fails). ## An agent can work from this page alone Once wired as MCP tools, an agent can answer these directly: | | | User asks | Agent calls | Note | | "Where are the Dow / NASDAQ / S&P?" | `ashare_quote(code="usDJI,usIXIC,usINX")` | S&P 500 is `usINX`, not usSPX | | "Apple target price?" | `ashare_rating(codes="usAAPL")` | Target is `targetPriceAvg` | | "How much of Apple is shorted?" | `ashare_fund_short(code="usAAPL", date="2026-09-30")` | ⚠️ without date only identifier fields | | "Apple financials" | `ashare_finance(code="usAAPL")` | Field conventions differ from A-shares | | "When do they report?" | `ashare_disclosure(codes="usAAPL")` | Earnings disclosure date | | "Screen for low-PE US stocks" | `ashare_screen(market="us", expr="intersect([PeTTM > 0])")` | ⚠️ must use `PeTTM` "Where are the Dow / NASDAQ / S&P?" `ashare_quote(code="usDJI,usIXIC,usINX")` S&P 500 is `usINX`, not usSPX "Apple target price?" `ashare_rating(codes="usAAPL")` Target is `targetPriceAvg` "How much of Apple is shorted?" `ashare_fund_short(code="usAAPL", date="2026-09-30")` ⚠️ without date only identifier fields "Apple financials" `ashare_finance(code="usAAPL")` Field conventions differ from A-shares "When do they report?" `ashare_disclosure(codes="usAAPL")` Earnings disclosure date "Screen for low-PE US stocks" `ashare_screen(market="us", expr="intersect([PeTTM > 0])")` ⚠️ must use `PeTTM` ⚠️ **Three rules for agents**: (1) US codes are `us` + uppercase (`usAAPL`); (2) use [/v1/search](/en/docs/endpoints/search) to confirm codes; (3) the US has **no shareholder detail / events calendar / buybacks / consensus / per-stock money flow** — those endpoints return empty. ## Boundaries up front (6 items) US coverage is narrower than A-shares; these are limits, not bugs: No shareholder detail [/v1/shareholder](/en/docs/endpoints/shareholder) covers A-shares and HK only — no top holders or institutional positions for US names. No events calendar [/v1/calendar](/en/docs/endpoints/calendar) (dividends / lock-ups / meetings) covers A-shares and HK only; use `disclosure` for US earnings dates. No buybacks, no consensus [/v1/buyback](/docs/endpoints/buyback) and [/v1/consensus](/docs/endpoints/consensus) cover A-shares and HK only. For US targets and estimates use [/v1/rating](/docs/endpoints/rating). No per-stock money flow [/v1/fund-flow](/docs/endpoints/fund-flow) covers A-shares and HK only. On the US side only the **short** leg exists ([/v1/fund-short](/docs/endpoints/fund-short)). No US index constituents [/v1/index-constituent](/docs/endpoints/index-constituent) covers A-share and HK indices (Hang Seng / HSCEI / TECH); there is no S&P constituent list. No date ranges for US K-lines Use `count` for the last N daily bars — same limit as HK. ## FAQ How do I write a US code? **us + uppercase letters**: Apple `usAAPL`, Tesla `usTSLA`. Different from HK (5 digits, `hk00700`) and A-shares (6 digits, `sh600519`). Use [/v1/search](/en/docs/endpoints/search) if unsure. Why can I not find the S&P 500? The code is **usINX**, not `usSPX` (measured 7,663.43). `usSPX` / `usGSPC` / `usSPX500` all return nothing. Is money flow available for US stocks? **Only short selling** ([/v1/fund-short](/docs/endpoints/fund-short): short ratio, days to cover, shares shorted). There is no main/retail money-flow endpoint. Can I run factor screening on US stocks? Yes — `/v1/screen?market=us` works (measured), but the expression field is **PeTTM** (not `PE_TTM`), and it is case-sensitive. Is US data available free? [/v1/quote](/en/docs/endpoints/quote) and [/v1/kline](/en/docs/endpoints/kline) are free (including the three indices); financials, ratings, short data and screening need Standard (¥29.9) or Pro (¥99). ## Go deeper Related docs: [US capability audit (16 entries + measurements) 14 command-level + short + screening · the 7 items missing vs HK](/en/docs)[Quote endpoint (incl. three indices) US index codes usDJI / usIXIC / usINX](/en/docs/endpoints/quote)[Short selling endpoint HK/US short data · date required](/docs/endpoints/fund-short) Start with the three indices [/v1/quote](/en/docs/endpoints/quote) and [/v1/kline](/en/docs/endpoints/kline) are free without a key — query the Dow, NASDAQ and S&P 500 directly. [MCP setup](/en/mcp)[See pricing](/en/pricing)