> ## 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 "https://api.reportify.cn/v1/quant/quotes/minute?symbol=000001&start_datetime=2026-04-01%2009:30:00&end_datetime=2026-04-01%2015:00:00&market=cn" \
    -H "Authorization: Bearer <token>"
  ```

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

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

  ```typescript TypeScript theme={null}
  const response = await fetch('https://api.reportify.cn/v1/quant/quotes/minute?symbol=000001&start_datetime=2026-04-01%2009:30:00&end_datetime=2026-04-01%2015:00:00&market=cn', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer <token>'
    }
  });
  const data = await response.json();
  ```
</CodeGroup>

## 请求参数

<ParamField query="symbol" type="string" required>
  股票代码
</ParamField>

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

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

<ParamField query="market" type="string" default="cn">
  股票市场：`cn`（A股）, `hk`（港股）, `us`（美股）
</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">
  查询元数据

  <Expandable title="元数据字段">
    <ResponseField name="start_datetime" type="string">
      查询开始时间
    </ResponseField>

    <ResponseField name="end_datetime" type="string">
      查询结束时间
    </ResponseField>

    <ResponseField name="count" type="integer">
      返回数据条数
    </ResponseField>
  </Expandable>
</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: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:32:00",
      "symbol": "000001",
      "current": 10.60,
      "high": 10.65,
      "low": 10.57,
      "avg": 10.60,
      "volume": 3456789,
      "amount": 36642163.40,
      "chg_percent": 0.3802,
      "chg": 0.04
    }
  ],
  "metadata": {
    "start_datetime": "2026-04-01 09:30:00",
    "end_datetime": "2026-04-01 15:00:00",
    "count": 3
  }
}
```

## 使用示例

### 获取当日交易数据

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

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

for row in data["datas"][:10]:
    print(f"{row['date']}: 价{row['current']} 量{row['volume']}")
```

### 获取港股数据

```python theme={null}
response = requests.get(
    "https://api.reportify.cn/v1/quant/quotes/minute",
    headers={"Authorization": "Bearer <token>"},
    params={
        "symbol": "00700",
        "start_datetime": "2026-04-01 09:30:00",
        "end_datetime": "2026-04-01 16:00:00",
        "market": "hk"
    }
)
```

### 获取美股数据

```python theme={null}
response = requests.get(
    "https://api.reportify.cn/v1/quant/quotes/minute",
    headers={"Authorization": "Bearer <token>"},
    params={
        "symbol": "AAPL",
        "start_datetime": "2026-04-01 09:30:00",
        "end_datetime": "2026-04-01 16:00:00",
        "market": "us"
    }
)
```


## OpenAPI

````yaml GET /v1/quant/quotes/minute
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:
    get:
      tags:
        - openapi-quant
      summary: Get minute data
      description: >
        Get minute data for a single symbol.


        - **symbol**: 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
      operationId: quote_minute
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            title: Symbol
          description: Stock code
          example: '000001'
        - name: start_datetime
          in: query
          required: true
          schema:
            type: string
            title: Start Datetime
          description: Start datetime
          example: '2026-04-28 09:30:00'
        - name: end_datetime
          in: query
          required: true
          schema:
            type: string
            title: End Datetime
          description: End datetime
          example: '2026-04-28 15:00:00'
        - name: market
          in: query
          required: false
          schema:
            type: string
            enum:
              - cn
              - hk
              - us
            default: cn
            title: Market
          description: Stock market
      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:
    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
    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

````