ashareapi-com Market Kline API

openapi: 3.2.0
info:
  title: A股数据 Market Kline API
  description: 多源数据通道（自动切换） · 行情/财务/资金/选股/宏观/可转债/ETF
  version: 0.1.0
tags:
- name: Market Kline
paths:
  /v1/market-kline:
    get:
      summary: 全市场单日 K 线（一次拿全 A 股某日行情）
      description: '**一次请求返回全市场（5000+ 只 A 股）在某一交易日的日线** —— 适合「每日增量更新全市场」，替代逐只调用（省 5000+ 次请求）。


        典型用法：每天收盘后调一次，取当日全市场 K 线入库。

        ```

        GET /v1/market-kline?date=2026-09-30

        ```


        ⚠️ **两种限定（务必看清）**：

        | | 说明 |

        |---|---|

        | 档位 | **仅 `pro`（¥99）与 `unlimited`（¥199）** —— `standard` 及以下不可用 |

        | 计费 | **1 次调用 = 折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）|


        ⚠️ 日额度：`pro` 200 次/日 · `unlimited` 1000 次/日（另计，见重型额度）。

        ⚠️ 字段固定 7 列：`code` `time` `open` `high` `low` `close` `volume` `amount`（**不复权原始价**）。

        ⚠️ 数据范围：**2016-08-08 起**、**仅 A 股股票**（5572 只）—— 不含 ETF / 可转债 / 指数 / 板块 / 港股 / 美股。数据由官方 dump 每日增量维护，**最新可到前一交易日**（当日盘中数据不可用）。

        ⚠️ 体积：单日全市场约 **785 KB**（实测 5560 只）。'
      operationId: market_kline_v1_market_kline_get
      parameters:
      - name: date
        in: query
        required: true
        schema:
          type: string
          description: 交易日 YYYY-MM-DD（如 2026-09-30；⛔ 非交易日返回空）
          title: Date
        description: 交易日 YYYY-MM-DD（如 2026-09-30；⛔ 非交易日返回空）
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          description: 分页：每次最多返回 N 只（0 = 全部 5000+ 只）
          default: 0
          title: Limit
        description: 分页：每次最多返回 N 只（0 = 全部 5000+ 只）
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          description: 分页偏移（配合 limit 使用）
          default: 0
          title: Offset
        description: 分页偏移（配合 limit 使用）
      - name: codes
        in: query
        required: false
        schema:
          type: string
          description: 可选：只取指定股票，逗号分隔（如 sh600519,sz000001；省略 = 全市场）
          default: ''
          title: Codes
        description: 可选：只取指定股票，逗号分隔（如 sh600519,sz000001；省略 = 全市场）
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Market Kline
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError