> ## 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.

# Equity Intraday Prices

> 1h regular-session OHLCV bars for US equities — recent N bars or a short date range, US market hours only.

<Note icon="sparkles">
  **Available as MCP tool**: `equity_intraday_prices` — call directly from Claude / Cursor / any MCP client. See [MCP Server](/en/integration/mcp-server) for the 60-second setup.
</Note>

<Badge color="green" icon="circle-check">Live</Badge>
 
<Badge color="blue" size="sm">1 credit per call</Badge>

## What it does for your agent

`equity_intraday_prices` returns **1h** OHLCV bars for a single US equity (NYSE / NASDAQ) during the **regular trading session**. Use it as the **intraday pricing primitive** an agent reaches for when answering "how did this trade today / over the last few sessions, did it gap, did it reverse, how did it close" — without pulling overly fine minute-level data.

It is the short-lookback companion to [`equity_historical_prices`](/en/api/prices/equity-historical): same equity-bars family, same response envelope, but intraday bars and a tighter window. Two query modes share one endpoint: pass `limit` to get the most recent N closed bars, or pass `start_date + end_date` for a short window. Only **closed bars** are returned — the in-progress bar is never included.

## Response

<ResponseField name="data" type="EquityIntradayResult" required>
  <Expandable title="EquityIntradayResult fields">
    <ResponseField name="ticker" type="string" required>
      The stock ticker symbol (e.g. `AAPL`).
    </ResponseField>

    <ResponseField name="interval" type="string" required>
      Always `"1h"` — only hourly bars are supported.
    </ResponseField>

    <ResponseField name="prices" type="EquityIntradayBar[]" required>
      Hourly bars in chronological order. Regular-session, closed bars only.

      <Expandable title="EquityIntradayBar fields">
        <ResponseField name="open" type="number" required>Opening price of the bar.</ResponseField>
        <ResponseField name="high" type="number" required>High price of the bar.</ResponseField>
        <ResponseField name="low" type="number" required>Low price of the bar.</ResponseField>
        <ResponseField name="close" type="number" required>Closing price of the bar.</ResponseField>
        <ResponseField name="volume" type="number" required>Trading volume during the bar.</ResponseField>
        <ResponseField name="time" type="string" required>Bar start time as an ISO 8601 UTC timestamp (e.g. `2026-06-18T14:30:00Z`).</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">Credits consumed (always `1`).</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">Account credits remaining.</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 }
}
```

## Notes

<Tip>
  `time` is an ISO 8601 **UTC** timestamp marking the start of each bar. Bars cover the US regular session, so convert to `America/New_York` if you need exchange-local hours.
</Tip>

<Tip>
  Use `data.prices.length` when you need the returned bar count; `meta` is reserved for credits and optional notices.
</Tip>

<Warning>
  **Hourly interval only.** Minute-level (`1m`, `5m`, `15m`) and `30m` bars are not exposed. Pass `interval=1h` or omit it; any other value returns a `400` error.
</Warning>

<Warning>
  **Regular session only.** Pre-market and after-hours bars are not included. For full trading days, use [`equity_historical_prices`](/en/api/prices/equity-historical).
</Warning>

<Warning>
  **No real-time quote.** The current, still-forming bar is excluded until it closes. For the latest tick, this tool isn't the right primitive.
</Warning>

<Warning>
  **Short lookback.** Recent mode caps at `70` bars (\~10 trading days); range mode caps at a `14` calendar-day window. For longer history, use daily bars.
</Warning>

## Direct invocation

<Accordion title="HTTP / SDK examples" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    // Recent mode — last 35 bars (~5 trading days)
    {
      "method": "tools/call",
      "params": {
        "name": "equity_intraday_prices",
        "arguments": { "ticker": "AAPL", "limit": 35 }
      }
    }

    // Range mode — short explicit window
    {
      "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 mode
    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 mode
    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 mode
    curl "https://api.llmquantdata.com/api/equity/intraday?ticker=AAPL&limit=35" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"

    # Range mode
    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>

## Full parameter reference

<Accordion title="equity_intraday_prices — request parameters" icon="sliders">
  <ParamField query="ticker" type="string" required>
    US equity ticker (e.g. `AAPL`, `MSFT`, `BRK.B`, `^GSPC` for S\&P 500 index).
  </ParamField>

  <ParamField query="interval" type="string" default="1h">
    Bar interval. Only `1h` is supported; any other value returns a `400` error.
  </ParamField>

  <Tabs>
    <Tab title="Recent mode">
      Pass `limit` only (or omit it for the default). Returns the most recent N closed `1h` bars.

      <ParamField query="limit" type="integer" default={35}>
        Number of recent bars. Default `35` (\~5 trading days). Max `70` (\~10 trading days).
      </ParamField>
    </Tab>

    <Tab title="Range mode">
      Pass `start_date` and `end_date` together. Returns all closed `1h` bars whose trading day falls in the inclusive range (interpreted in `America/New_York`).

      <ParamField query="start_date" type="string" required>
        Start of date range in `YYYY-MM-DD` (e.g. `2026-06-08`). Must be paired with `end_date`.
      </ParamField>

      <ParamField query="end_date" type="string" required>
        End of date range in `YYYY-MM-DD`. Must be paired with `start_date`.
      </ParamField>

      <Warning>
        Passing only `start_date` or only `end_date` returns a `400` error. Combining `limit` with `start_date`/`end_date` also returns a `400` — pick one mode. A window longer than `14` calendar days returns a `400`.
      </Warning>
    </Tab>
  </Tabs>
</Accordion>

## Related

<Columns cols={2}>
  <Card title="Equity Historical Prices" icon="chart-line" href="/en/api/prices/equity-historical">
    Daily OHLCV bars with adjusted close, dividends, and splits — the long-lookback companion.
  </Card>

  <Card title="MCP Server setup" icon="plug" href="/en/integration/mcp-server">
    Connect Claude / Cursor / any harness in 60 seconds.
  </Card>
</Columns>