> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 美股盘中行情

> 美股 1h 盘中 OHLCV —— 支持最近 N 根 / 短日期范围两种模式，仅含常规交易时段。

<Note icon="sparkles">
  **已暴露为 MCP 工具**：`equity_intraday_prices` —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 [MCP Server](/zh-CN/integration/mcp-server) 60 秒配置。
</Note>

<Badge color="green" icon="circle-check">已上线</Badge>
 
<Badge color="blue" size="sm">每次 1 credit</Badge>

## 它为 Agent 做什么

`equity_intraday_prices` 返回单个美股标的（NYSE / NASDAQ）在 **常规交易时段** 的 **1h** OHLCV 盘中 bar。它是 agent 回答"今天 / 最近几天盘中怎么走、有没有跳空、有没有反转、收盘前怎么动"这类问题的 **盘中价格 primitive** —— 不用拉过细的分钟级数据。

它是 [`equity_historical_prices`](/zh-CN/api/prices/equity-historical) 的短窗口搭档：同属 equity bars 家族、同一套返回信封，但返回的是盘中 bar，且窗口更短。同一个接口支持两种查询模式：传 `limit` 取最近 N 根已收盘 bar，或者传 `start_date + end_date` 取一个短窗口。**只返回已收盘的 bar**，当前未走完的 bar 永远不在结果里。

## 返回值

<ResponseField name="data" type="EquityIntradayResult" required>
  <Expandable title="EquityIntradayResult 字段">
    <ResponseField name="ticker" type="string" required>
      美股 ticker（如 `AAPL`）。
    </ResponseField>

    <ResponseField name="interval" type="string" required>
      固定 `"1h"`，仅支持小时线。
    </ResponseField>

    <ResponseField name="prices" type="EquityIntradayBar[]" required>
      按时间正序返回的小时线数组。仅含常规交易时段、已收盘的 bar。

      <Expandable title="EquityIntradayBar 字段">
        <ResponseField name="open" type="number" required>该 bar 的开盘价。</ResponseField>
        <ResponseField name="high" type="number" required>该 bar 的最高价。</ResponseField>
        <ResponseField name="low" type="number" required>该 bar 的最低价。</ResponseField>
        <ResponseField name="close" type="number" required>该 bar 的收盘价。</ResponseField>
        <ResponseField name="volume" type="number" required>该 bar 内的成交量。</ResponseField>
        <ResponseField name="time" type="string" required>bar 起始时间，ISO 8601 UTC 时间戳（如 `2026-06-18T14:30:00Z`）。</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">本次调用消耗的 credit（固定 `1`）。</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">账户剩余 credit。</ResponseField>

```json title="200 OK · equity_intraday_prices" expandable theme={null}
{
  "data": {
    "ticker": "AAPL",
    "interval": "1h",
    "prices": [
      {
        "open": 181.20,
        "high": 181.95,
        "low": 180.85,
        "close": 181.60,
        "volume": 4821000,
        "time": "2026-06-18T13:30:00Z"
      },
      {
        "open": 181.60,
        "high": 182.40,
        "low": 181.40,
        "close": 182.10,
        "volume": 3950000,
        "time": "2026-06-18T14:30:00Z"
      }
    ]
  },
  "meta": { "creditsUsed": 1, "remainingCredits": 99 }
}
```

## 说明

<Tip>
  `time` 是 ISO 8601 **UTC** 时间戳，标记每根 bar 的起始时刻。bar 覆盖美股常规交易时段，需要交易所本地时间时请转换到 `America/New_York`。
</Tip>

<Tip>
  需要本次返回 bar 数时，用 `data.prices.length`；`meta` 只放 credit 和可选 notice。
</Tip>

<Warning>
  **仅小时线**。分钟级（`1m`、`5m`、`15m`）和 `30m` 都不支持。传 `interval=1h` 或省略；传其他值会返回 `400`。
</Warning>

<Warning>
  **仅常规交易时段**。不含盘前 / 盘后 bar。需要完整交易日请用 [`equity_historical_prices`](/zh-CN/api/prices/equity-historical)。
</Warning>

<Warning>
  **没有实时报价**。当前正在形成、未收盘的 bar 不在结果里。要拿"最新价"用别的工具。
</Warning>

<Warning>
  **窗口短**。Recent 模式最多 `70` 根（约 10 个交易日）；Range 模式最多 `14` 个自然日窗口。要更长历史请用日线。
</Warning>

## 直接调用

<Accordion title="HTTP / SDK 示例" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    // Recent 模式 —— 最近 35 根（约 5 个交易日）
    {
      "method": "tools/call",
      "params": {
        "name": "equity_intraday_prices",
        "arguments": { "ticker": "AAPL", "limit": 35 }
      }
    }

    // Range 模式 —— 短窗口
    {
      "method": "tools/call",
      "params": {
        "name": "equity_intraday_prices",
        "arguments": {
          "ticker": "MSFT",
          "start_date": "2026-06-08",
          "end_date": "2026-06-18"
        }
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

    # Recent 模式
    resp = requests.get(
        "https://api.llmquantdata.com/api/equity/intraday",
        headers=headers,
        params={"ticker": "AAPL", "limit": 35},
    ).json()
    for bar in resp["data"]["prices"]:
        print(f"{bar['time']}  C={bar['close']:.2f}  V={bar['volume']}")

    # Range 模式
    resp = requests.get(
        "https://api.llmquantdata.com/api/equity/intraday",
        headers=headers,
        params={
            "ticker": "MSFT",
            "start_date": "2026-06-08",
            "end_date": "2026-06-18",
        },
    ).json()
    print(f"Range mode returned {len(resp['data']['prices'])} bars")
    ```

    ```bash cURL theme={null}
    # Recent 模式
    curl "https://api.llmquantdata.com/api/equity/intraday?ticker=AAPL&limit=35" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"

    # Range 模式
    curl "https://api.llmquantdata.com/api/equity/intraday?ticker=MSFT&start_date=2026-06-08&end_date=2026-06-18" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## 完整参数参考

<Accordion title="equity_intraday_prices — 请求参数" icon="sliders">
  <ParamField query="ticker" type="string" required>
    美股 ticker（如 `AAPL`、`MSFT`、`BRK.B`、`^GSPC`（S\&P 500 指数））。
  </ParamField>

  <ParamField query="interval" type="string" default="1h">
    bar 周期。仅支持 `1h`；传其他值会返回 `400`。
  </ParamField>

  <Tabs>
    <Tab title="Recent 模式">
      只传 `limit`（或省略走默认值）。返回最近 N 根已收盘 `1h` bar。

      <ParamField query="limit" type="integer" default={35}>
        最近多少根 bar。默认 `35`（约 5 个交易日），最大 `70`（约 10 个交易日）。
      </ParamField>
    </Tab>

    <Tab title="Range 模式">
      `start_date` 和 `end_date` 必须同时传。返回交易日落在闭区间内（按 `America/New_York` 解释）的所有已收盘 `1h` bar。

      <ParamField query="start_date" type="string" required>
        起始日期，`YYYY-MM-DD`（如 `2026-06-08`）。必须与 `end_date` 同时使用。
      </ParamField>

      <ParamField query="end_date" type="string" required>
        结束日期，`YYYY-MM-DD`。必须与 `start_date` 同时使用。
      </ParamField>

      <Warning>
        单独传 `start_date` 或 `end_date` 会返回 `400`。`limit` 与 `start_date`/`end_date` 同时传也会返回 `400` —— 二选一。窗口超过 `14` 个自然日会返回 `400`。
      </Warning>
    </Tab>
  </Tabs>
</Accordion>

## 相关接口

<Columns cols={2}>
  <Card title="美股历史日线" icon="chart-line" href="/zh-CN/api/prices/equity-historical">
    日线 OHLCV，含复权价、分红、拆股 —— 长窗口搭档。
  </Card>

  <Card title="MCP Server 接入" icon="plug" href="/zh-CN/integration/mcp-server">
    60 秒接入 Claude / Cursor / 任意 agent harness。
  </Card>
</Columns>