> ## 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 根，或一段不超过 14 个自然日的日期窗口，仅含常规交易时段。

<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。用 `start_date` 和/或 `end_date` 先过滤候选窗口，再用 `limit` 和 `take_from` 决定保留哪一端。查询窗口最多 **14 个自然日**。**只返回已收盘的 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>
  **最多 14 个自然日**。查询窗口（含两端）不能超过 14 个自然日，更宽的窗口返回 `400`，且不扣 credit。判据看**有效窗口**：`end_date` 省略时按当前美东日期算，所以只传 `start_date=2015-01-01` 一样会被拒。请缩小窗口，或改用 [`equity_historical_prices`](/zh-CN/api/prices/equity-historical) 拉更长区间的日线。
</Warning>

<Warning>
  返回始终由 `limit` 收敛（默认 `35`，最大 `70`）。要看长期历史请用日线。
</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 }
      }
    }

    // 日期窗口内最早 10 根
    {
      "method": "tools/call",
      "params": {
        "name": "equity_intraday_prices",
        "arguments": {
          "ticker": "MSFT",
          "start_date": "2026-06-08",
          "end_date": "2026-06-18",
          "limit": 10,
          "take_from": "earliest"
        }
      }
    }
    ```

    ```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']}")

    # 日期窗口内最早 10 根
    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",
            "limit": 10,
            "take_from": "earliest",
        },
    ).json()
    print(f"Bounded query 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"

    # 日期窗口内最早 10 根
    curl "https://api.llmquantdata.com/api/equity/intraday?ticker=MSFT&start_date=2026-06-08&end_date=2026-06-18&limit=10&take_from=earliest" \
      -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>

  <ParamField query="start_date" type="string">
    可选 inclusive 交易日下边界，`YYYY-MM-DD`（按 `America/New_York` 解释）。它开出的窗口必须落在 `end_date` 之前 14 个自然日内；`end_date` 省略时按当前美东日期算。
  </ParamField>

  <ParamField query="end_date" type="string">
    可选 inclusive 交易日上边界，`YYYY-MM-DD`（按 `America/New_York` 解释）。省略时默认取当前美东日期。
  </ParamField>

  <ParamField query="limit" type="integer" default={35}>
    边界过滤后最多返回多少根 `1h` bar。默认 `35`，最大 `70`。
  </ParamField>

  <ParamField query="take_from" type="string" default="latest">
    当过滤后候选超过 `limit` 时保留哪一端：`latest` 或 `earliest`。输出仍按时间正序。
  </ParamField>

  <Warning>
    `take_from=earliest` 需要 `start_date`。如果同时传两个日期边界，`start_date` 不能晚于 `end_date`。无论哪种情况，最终窗口都不能超过 14 个自然日，否则返回 `400` 且不扣 credit。
  </Warning>
</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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.