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

# 批量分时数据

> 批量获取多只股票的分时数据

批量获取多只股票的分时数据。

数据按日期（升序）和股票代码排序。

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.reportify.cn/v1/quant/quotes/minute/batch" \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "market": "cn",
      "symbols": ["000001", "000002", "600519"],
      "start_datetime": "2026-04-01 09:30:00",
      "end_datetime": "2026-04-01 15:00:00"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.reportify.cn/v1/quant/quotes/minute/batch",
      headers={"Authorization": "Bearer <token>"},
      json={
          "market": "cn",
          "symbols": ["000001", "000002", "600519"],
          "start_datetime": "2026-04-01 09:30:00",
          "end_datetime": "2026-04-01 15:00:00"
      }
  )
  print(response.json())
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch('https://api.reportify.cn/v1/quant/quotes/minute/batch', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <token>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      market: 'cn',
      symbols: ['000001', '000002', '600519'],
      start_datetime: '2026-04-01 09:30:00',
      end_datetime: '2026-04-01 15:00:00'
    })
  });
  const data = await response.json();
  ```
</CodeGroup>

## 请求参数

<ParamField body="market" type="string" default="cn">
  股票市场：`cn`（A股）, `hk`（港股）, `us`（美股）
</ParamField>

<ParamField body="symbols" type="string[]" required>
  股票代码列表（至少 1 个）
</ParamField>

<ParamField body="start_datetime" type="string" required>
  开始时间，格式：`YYYY-MM-DD HH:MM:SS`
</ParamField>

<ParamField body="end_datetime" type="string" required>
  结束时间，格式：`YYYY-MM-DD HH:MM:SS`
</ParamField>

## 响应参数

<ResponseField name="datas" type="array">
  分时数据列表，按日期（升序）和股票代码排序

  <Expandable title="数据字段">
    <ResponseField name="market" type="string">
      股票市场（cn / hk / us）
    </ResponseField>

    <ResponseField name="date" type="string">
      日期时间，格式：`YYYY-MM-DD HH:MM:SS`
    </ResponseField>

    <ResponseField name="symbol" type="string">
      股票代码
    </ResponseField>

    <ResponseField name="current" type="number">
      当前价
    </ResponseField>

    <ResponseField name="high" type="number">
      最高价
    </ResponseField>

    <ResponseField name="low" type="number">
      最低价
    </ResponseField>

    <ResponseField name="avg" type="number">
      均价
    </ResponseField>

    <ResponseField name="volume" type="integer">
      成交量（股）
    </ResponseField>

    <ResponseField name="amount" type="number">
      成交额（元）
    </ResponseField>

    <ResponseField name="chg_percent" type="number">
      涨跌幅（%）
    </ResponseField>

    <ResponseField name="chg" type="number">
      涨跌额
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  查询元数据
</ResponseField>

## 响应示例

```json theme={null}
{
  "datas": [
    {
      "market": "cn",
      "date": "2026-04-01 09:30:00",
      "symbol": "000001",
      "current": 10.58,
      "high": 10.62,
      "low": 10.55,
      "avg": 10.59,
      "volume": 1234567,
      "amount": 13072345.67,
      "chg_percent": 0.1899,
      "chg": 0.02
    },
    {
      "market": "cn",
      "date": "2026-04-01 09:30:00",
      "symbol": "000002",
      "current": 15.80,
      "high": 15.95,
      "low": 15.75,
      "avg": 15.85,
      "volume": 987654,
      "amount": 15652345.60,
      "chg_percent": 0.3185,
      "chg": 0.05
    },
    {
      "market": "cn",
      "date": "2026-04-01 09:31:00",
      "symbol": "000001",
      "current": 10.61,
      "high": 10.65,
      "low": 10.58,
      "avg": 10.60,
      "volume": 2345678,
      "amount": 24864187.80,
      "chg_percent": 0.4751,
      "chg": 0.05
    },
    {
      "market": "cn",
      "date": "2026-04-01 09:31:00",
      "symbol": "000002",
      "current": 15.90,
      "high": 16.10,
      "low": 15.85,
      "avg": 15.92,
      "volume": 1876543,
      "amount": 29843567.30,
      "chg_percent": 0.9554,
      "chg": 0.15
    }
  ],
  "metadata": {
    "market": "cn",
    "symbols": ["000001", "000002", "600519"],
    "start_datetime": "2026-04-01 09:30:00",
    "end_datetime": "2026-04-01 15:00:00",
    "count": 4
  }
}
```

## 使用示例

### 批量获取当日交易数据

```python theme={null}
import requests
from datetime import datetime
from collections import defaultdict

today = datetime.now().strftime("%Y-%m-%d")
response = requests.post(
    "https://api.reportify.cn/v1/quant/quotes/minute/batch",
    headers={"Authorization": "Bearer <token>"},
    json={
        "market": "cn",
        "symbols": ["000001", "000002", "600519"],
        "start_datetime": f"{today} 09:30:00",
        "end_datetime": f"{today} 15:00:00"
    }
)
data = response.json()

# 按股票分组
by_symbol = defaultdict(list)
for row in data["datas"]:
    by_symbol[row["symbol"]].append(row)

# 输出每只股票的最新数据
for symbol, rows in by_symbol.items():
    latest = rows[-1]
    print(f"{symbol}: {latest['date']} 价{latest['current']} 量{latest['volume']}")
```

### 批量获取港股数据

```python theme={null}
response = requests.post(
    "https://api.reportify.cn/v1/quant/quotes/minute/batch",
    headers={"Authorization": "Bearer <token>"},
    json={
        "market": "hk",
        "symbols": ["00700", "09988", "09618"],
        "start_datetime": "2026-04-01 09:30:00",
        "end_datetime": "2026-04-01 16:00:00"
    }
)
```

### 批量获取美股数据

```python theme={null}
response = requests.post(
    "https://api.reportify.cn/v1/quant/quotes/minute/batch",
    headers={"Authorization": "Bearer <token>"},
    json={
        "market": "us",
        "symbols": ["AAPL", "MSFT", "GOOGL", "NVDA"],
        "start_datetime": "2026-04-01 09:30:00",
        "end_datetime": "2026-04-01 16:00:00"
    }
)
```


## OpenAPI

````yaml POST /v1/quant/quotes/minute/batch
openapi: 3.1.0
info:
  title: Reportify API
  version: 1.0.0
  description: API documentation for Reportify's document management and search services.
servers:
  - url: https://api.reportify.cn
    description: Production server
security:
  - BearerAuth: []
paths:
  /v1/quant/quotes/minute/batch:
    post:
      tags:
        - openapi-quant
      summary: Get batch minute data for multiple symbols
      description: >
        Get minute data for multiple symbols.


        - **symbols**: List of stock code (required)

        - **start_datetime**: Start datetime (required, format: YYYY-MM-DD
        HH:MM:SS)

        - **end_datetime**: End datetime (required, format: YYYY-MM-DD HH:MM:SS)

        - **market**: Stock market (cn, hk, us), default: cn


        Returns data sorted by date (ascending), then by symbol.
      operationId: quote_minute_batch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchMinuteInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MinuteOutput'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerAuth: []
components:
  schemas:
    BatchMinuteInput:
      type: object
      required:
        - symbols
        - start_datetime
        - end_datetime
      properties:
        symbols:
          type: array
          title: Symbols
          description: List of stock codes (required)
          minItems: 1
          items:
            type: string
        start_datetime:
          type: string
          title: Start Datetime
          description: Start datetime (YYYY-MM-DD HH:MM:SS) (required)
        end_datetime:
          type: string
          title: End Datetime
          description: End datetime (YYYY-MM-DD HH:MM:SS) (required)
        market:
          $ref: '#/components/schemas/StockMarket'
          description: Stock market
          default: cn
        stock_type:
          $ref: '#/components/schemas/StockType'
          default: stock
          description: Stock type
      title: BatchMinuteInput
      description: Input for batch minute data request.
    MinuteOutput:
      type: object
      required:
        - datas
        - metadata
      properties:
        datas:
          type: array
          title: Datas
          description: Minute data list
          items:
            type: object
            additionalProperties: true
        metadata:
          type: object
          title: Metadata
          description: Query metadata
          additionalProperties: true
      title: MinuteOutput
      description: Minute data response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    StockMarket:
      type: string
      enum:
        - cn
        - hk
        - us
        - global
      title: StockMarket
      description: Stock market identifier
    StockType:
      type: string
      enum:
        - stock
        - etf
        - index
        - sw
      title: StockType
      description: Stock type identifier
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter your Bearer token

````