### GET /v1/klines/batch Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E6%89%B9%E9%87%8F%E8%8E%B7%E5%8F%96k%E7%BA%BF%E6%95%B0%E6%8D%AE 批量获取多个标的的K线数据，响应以标的代码为 key。 ```APIDOC ## GET /v1/klines/batch ### Description 一次请求获取多个标的的K线数据，响应以标的代码为 key。 ### Method GET ### Endpoint /v1/klines/batch ### Parameters #### Query Parameters - **symbols** (string) - Required - 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） - **period** (string) - Optional - K线周期。分钟级（1m/5m/15m/30m/60m）需要分钟K线权限，日/周/月/季/年需要日K线权限。 - **count** (integer) - Optional - 最大返回条数（默认 100，最大 10000） - **start_time** (integer) - Optional - 起始时间戳（毫秒，含） - **end_time** (integer) - Optional - 结束时间戳（毫秒，含） - **adjust** (string) - Optional - 复权类型：`none`（不复权）、`forward`（前复权）、`backward`（后复权）、`forward_additive`（前复权-差值）、`backward_additive`（后复权-差值） ### Response #### Success Response (200) - **data** (object) - 以标的代码为 key 的K线数据字典，包含列式OHLCV数据（timestamp, open, high, low, close, volume, amount） ``` -------------------------------- ### 获取除权因子 OpenAPI 定义 Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E8%8E%B7%E5%8F%96%E9%99%A4%E6%9D%83%E5%9B%A0%E5%AD%90 定义了获取除权因子的 GET 请求路径、参数及响应结构。 ```yaml openapi: 3.1.0 info: contact: email: support@quantdash.net description: 提供中国A股、ETF、美股、港股的实时和历史行情数据接口 title: QuantDash version: 1.0.0 servers: - url: https://api.quantdash.net security: - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - description: 历史K线（OHLCV）数据 name: K线数据 - description: 实时报价和市场深度 name: 实时行情 - description: 日内分钟级别数据 name: 日内分时 - description: 标的元数据 name: 基础信息 paths: /v1/klines/ex-factors: get: tags: - K线数据 summary: 获取除权因子 description: 获取标的的历史除权除息调整因子，可用于计算复权价格。 operationId: getExFactors parameters: - description: 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） example: 600000.SH,000001.SZ in: query name: symbols required: true schema: type: string - description: 起始时间戳（毫秒，含） in: query name: start_time schema: format: int64 type: integer - description: 结束时间戳（毫秒，含） in: query name: end_time schema: format: int64 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExFactorsResponse' description: 除权因子数据 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: schemas: ExFactorsResponse: description: 以标的代码为 key 的除权因子历史字典 properties: data: additionalProperties: items: $ref: '#/components/schemas/ExFactorEntry' type: array type: object required: - data type: object ExFactorEntry: properties: ex_factor: description: 除权因子 type: number timestamp: description: 除权日时间戳（毫秒） format: int64 type: integer required: - timestamp - ex_factor type: object ErrorResponse: description: 错误响应 properties: code: description: HTTP 状态码 type: integer message: description: 错误描述 type: string required: - code - message type: object RateLimitResponse: description: 限流响应 properties: code: example: 429 type: integer message: description: 限流说明 type: string retry_after_ms: description: 建议等待时间（毫秒） type: integer required: - code - message - retry_after_ms type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: API Key 无效或缺失 Forbidden: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 当前套餐无此功能/市场权限 RateLimited: content: application/json: schema: $ref: '#/components/schemas/RateLimitResponse' description: 请求频率超限 securitySchemes: ApiKeyHeader: description: 在请求头 X-API-Key 中传递 API Key in: header name: X-API-Key type: apiKey ApiKeyQuery: description: 在 URL 查询参数 api_key 中传递 API Key in: query name: api_key type: apiKey ``` -------------------------------- ### GET /v1/depth/batch Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85/%E6%89%B9%E9%87%8F%E8%8E%B7%E5%8F%96%E5%B8%82%E5%9C%BA%E6%B7%B1%E5%BA%A6%EF%BC%88%E4%BA%94%E6%A1%A3%E8%A1%8C%E6%83%85%EF%BC%89 批量获取多个标的的五档盘口数据，包括买入和卖出的价格及数量。 ```APIDOC ## GET /v1/depth/batch ### Description 一次请求获取多个标的盘口数据（5档买卖价格和数量）。 ### Method GET ### Endpoint /v1/depth/batch ### Parameters #### Query Parameters - **symbols** (string) - Required - 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） ### Response #### Success Response (200) - **data** (object) - 以标的代码为 key 的市场深度数据字典，包含 ask_prices, ask_volumes, bid_prices, bid_volumes, region, symbol, timestamp 等字段。 ``` -------------------------------- ### GET /v1/depth Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85/%E8%8E%B7%E5%8F%96%E5%B8%82%E5%9C%BA%E6%B7%B1%E5%BA%A6%EF%BC%88%E4%BA%94%E6%A1%A3%E8%A1%8C%E6%83%85%EF%BC%89 获取单个标的盘口数据（5档买卖价格和数量）。 ```APIDOC ## GET /v1/depth ### Description 获取单个标的盘口数据（5档买卖价格和数量）。 ### Method GET ### Endpoint /v1/depth ### Parameters #### Query Parameters - **symbol** (string) - Required - 标的代码（如 `600000.SH`、`AAPL.US`、`00700.HK`） ### Response #### Success Response (200) - **data** (object) - 市场深度数据 - **symbol** (string) - 标的代码 - **region** (string) - 市场地区 (CN, US, HK) - **timestamp** (integer) - 时间戳（毫秒） - **bid_prices** (array) - 买入价（买1到买5，降序） - **bid_volumes** (array) - 买入量 - **ask_prices** (array) - 卖出价（卖1到卖5，升序） - **ask_volumes** (array) - 卖出量 ``` -------------------------------- ### GET /v1/quotes Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85/%E8%8E%B7%E5%8F%96%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85 获取最新实时报价。支持按标的代码查询或按标的池查询。两种方式二选一。 ```APIDOC ## GET /v1/quotes ### Description 获取最新实时报价。支持按标的代码查询或按标的池查询。两种方式二选一。 ### Method GET ### Endpoint /v1/quotes ### Parameters #### Query Parameters - **symbols** (string) - Optional - 标的代码，逗号分隔（如 600000.SH,000001.SZ,AAPL.US） - **universes** (string) - Optional - 标的池ID，逗号分隔。可选值：CN_Stock（A股）、US_Stock（美股）、HK_Stock（港股）、CN_ETF（ETF） ### Response #### Success Response (200) - **data** (array) - 行情数据列表 #### Response Example { "data": [ { "symbol": "600519.SH", "region": "CN", "last_price": 1800.0, "prev_close": 1790.0, "open": 1795.0, "high": 1810.0, "low": 1790.0, "volume": 10000, "amount": 18000000.0, "timestamp": 1672531200000 } ] } ``` -------------------------------- ### GET /v1/instruments Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%9F%BA%E7%A1%80%E4%BF%A1%E6%81%AF/%E8%8E%B7%E5%8F%96%E6%A0%87%E7%9A%84%E5%85%83%E6%95%B0%E6%8D%AE 根据标的代码获取元数据（名称、交易所、类型、上市日期等）。支持逗号分隔传入多个标的。 ```APIDOC ## GET /v1/instruments ### Description 根据标的代码获取元数据（名称、交易所、类型、上市日期等）。支持逗号分隔传入多个标的。 ### Method GET ### Endpoint /v1/instruments ### Parameters #### Query Parameters - **symbols** (string) - Required - 标的代码，逗号分隔（如 600000.SH,000001.SZ,AAPL.US） ### Response #### Success Response (200) - **data** (array) - 标的数据列表 - **symbol** (string) - 标的代码 - **exchange** (string) - 交易所代码（SH/SZ/HK/US等） - **code** (string) - 标的纯数字/字母代码 - **name** (string) - 标的名称 - **region** (string) - 市场地区 (CN, US, HK) - **type** (string) - 标的类型 (stock, etf, index, bond, fund, futures, options, other) - **ext** (object) - 标的扩展信息（包含 listing_date, total_shares, float_shares, tick_size, limit_up, limit_down 等） ``` -------------------------------- ### GET /v1/klines/intraday/batch Source: https://docs.quantdash.net/zh-hans/api-reference/%E6%97%A5%E5%86%85%E5%88%86%E6%97%B6/%E6%89%B9%E9%87%8F%E8%8E%B7%E5%8F%96%E6%97%A5%E5%86%85%E5%88%86%E6%97%B6%E6%95%B0%E6%8D%AE 一次请求获取多个标的的日内分钟级K线数据。 ```APIDOC ## GET /v1/klines/intraday/batch ### Description 一次请求获取多个标的的日内分钟级K线数据。 ### Method GET ### Endpoint /v1/klines/intraday/batch ### Parameters #### Query Parameters - **symbols** (string) - Required - 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） - **period** (string) - Optional - 分时周期，可选值: 1m, 5m, 10m, 15m, 30m, 60m。默认: 1m - **count** (integer) - Optional - 最大返回条数，最大值: 10000。默认: 100 ### Response #### Success Response (200) - **data** (object) - 以标的代码为 key 的K线数据字典，包含 timestamp, open, high, low, close, volume, amount 等数组数据。 #### Response Example { "data": { "600000.SH": { "timestamp": [1672531200000], "open": [10.5], "high": [10.6], "low": [10.4], "close": [10.55], "volume": [10000], "amount": [105000.0] } } } ``` -------------------------------- ### 批量获取市场深度 OpenAPI 定义 Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85/%E6%89%B9%E9%87%8F%E8%8E%B7%E5%8F%96%E5%B8%82%E5%9C%BA%E6%B7%B1%E5%BA%A6%EF%BC%88%E4%BA%94%E6%A1%A3%E8%A1%8C%E6%83%85%EF%BC%89 定义了 /v1/depth/batch GET 请求的参数、响应结构以及相关的错误处理模式。 ```yaml openapi: 3.1.0 info: contact: email: support@quantdash.net description: 提供中国A股、ETF、美股、港股的实时和历史行情数据接口 title: QuantDash version: 1.0.0 servers: - url: https://api.quantdash.net security: - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - description: 历史K线（OHLCV）数据 name: K线数据 - description: 实时报价和市场深度 name: 实时行情 - description: 日内分钟级别数据 name: 日内分时 - description: 标的元数据 name: 基础信息 paths: /v1/depth/batch: get: tags: - 实时行情 summary: 批量获取市场深度（五档行情） description: 一次请求获取多个标的盘口数据（5档买卖价格和数量）。 operationId: getDepthBatch parameters: - description: 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） example: 600000.SH,000001.SZ in: query name: symbols required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/DepthBatchResponse' description: 批量市场深度数据 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: schemas: DepthBatchResponse: description: 以标的代码为 key 的市场深度数据字典 properties: data: additionalProperties: $ref: '#/components/schemas/MarketDepth' type: object required: - data type: object MarketDepth: description: 五档盘口数据 properties: ask_prices: description: 卖出价（卖1到卖5，升序） items: type: number type: array ask_volumes: description: 卖出量 items: type: integer type: array bid_prices: description: 买入价（买1到买5，降序） items: type: number type: array bid_volumes: description: 买入量 items: type: integer type: array region: description: 市场地区 enum: - CN - US - HK type: string symbol: description: 标的代码 type: string timestamp: description: 时间戳（毫秒） format: int64 type: integer required: - symbol - region - timestamp - bid_prices - bid_volumes - ask_prices - ask_volumes type: object ErrorResponse: description: 错误响应 properties: code: description: HTTP 状态码 type: integer message: description: 错误描述 type: string required: - code - message type: object RateLimitResponse: description: 限流响应 properties: code: example: 429 type: integer message: description: 限流说明 type: string retry_after_ms: description: 建议等待时间（毫秒） type: integer required: - code - message - retry_after_ms type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: API Key 无效或缺失 Forbidden: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 当前套餐无此功能/市场权限 RateLimited: content: application/json: schema: $ref: '#/components/schemas/RateLimitResponse' description: 请求频率超限 securitySchemes: ApiKeyHeader: description: 在请求头 X-API-Key 中传递 API Key in: header name: X-API-Key type: apiKey ApiKeyQuery: description: 在 URL 查询参数 api_key 中传递 API Key in: query name: api_key type: apiKey ``` -------------------------------- ### GET /v1/klines/ex-factors Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E8%8E%B7%E5%8F%96%E9%99%A4%E6%9D%83%E5%9B%A0%E5%AD%90 获取标的的历史除权除息调整因子，可用于计算复权价格。 ```APIDOC ## GET /v1/klines/ex-factors ### Description 获取标的的历史除权除息调整因子，可用于计算复权价格。 ### Method GET ### Endpoint /v1/klines/ex-factors ### Parameters #### Query Parameters - **symbols** (string) - Required - 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） - **start_time** (integer) - Optional - 起始时间戳（毫秒，含） - **end_time** (integer) - Optional - 结束时间戳（毫秒，含） ### Response #### Success Response (200) - **data** (object) - 以标的代码为 key 的除权因子历史字典 #### Response Example { "data": { "600000.SH": [ { "timestamp": 1609459200000, "ex_factor": 1.05 } ] } } ``` -------------------------------- ### GET /v1/klines/intraday Source: https://docs.quantdash.net/zh-hans/api-reference/%E6%97%A5%E5%86%85%E5%88%86%E6%97%B6/%E8%8E%B7%E5%8F%96%E6%97%A5%E5%86%85%E5%88%86%E6%97%B6%E6%95%B0%E6%8D%AE 获取单个标的当日分钟级K线数据。支持 1m/5m/15m/30m/60m 周期。 ```APIDOC ## GET /v1/klines/intraday ### Description 获取单个标的当日分钟级K线数据。支持 1m/5m/15m/30m/60m 周期。 ### Method GET ### Endpoint /v1/klines/intraday ### Parameters #### Query Parameters - **symbol** (string) - Required - 标的代码（如 `600000.SH`、`AAPL.US`、`00700.HK`） - **period** (string) - Optional - 分时周期（可选值: 1m, 5m, 10m, 15m, 30m, 60m，默认: 1m） - **count** (integer) - Optional - 最大返回条数（最大: 10000，默认: 100） ### Response #### Success Response (200) - **data** (object) - 日内K线数据对象，包含 timestamp, open, high, low, close, volume, amount 等数组字段。 #### Response Example { "data": { "timestamp": [1672531200000], "open": [10.5], "high": [10.6], "low": [10.4], "close": [10.55], "volume": [10000], "amount": [105000] } } ``` -------------------------------- ### 设置环境变量 Source: https://docs.quantdash.net/zh-Hans/sdk/python-quickstart 通过 shell 环境变量配置 API Key。 ```bash export QUANTDASH_API_KEY="your-api-key" ``` -------------------------------- ### 获取K线数据 OpenAPI 定义 Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E8%8E%B7%E5%8F%96k%E7%BA%BF%E6%95%B0%E6%8D%AE 定义了获取K线数据的接口路径、参数及响应结构，包括支持的周期和复权类型。 ```yaml openapi: 3.1.0 info: contact: email: support@quantdash.net description: 提供中国A股、ETF、美股、港股的实时和历史行情数据接口 title: QuantDash version: 1.0.0 servers: - url: https://api.quantdash.net security: - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - description: 历史K线（OHLCV）数据 name: K线数据 - description: 实时报价和市场深度 name: 实时行情 - description: 日内分钟级别数据 name: 日内分时 - description: 标的元数据 name: 基础信息 paths: /v1/klines: get: tags: - K线数据 summary: 获取K线数据 description: 获取单个标的的OHLCV K线数据。支持日线、周线、月线和分钟级别。数据以列式格式返回，传输效率高。 operationId: getKlines parameters: - description: 标的代码（如 `600000.SH`、`AAPL.US`、`00700.HK`） example: 600000.SH in: query name: symbol required: true schema: type: string - description: K线周期。分钟级（1m/5m/15m/30m/60m）需要分钟K线权限，日/周/月/季/年需要日K线权限。 in: query name: period schema: $ref: '#/components/schemas/Period' - description: 最大返回条数 in: query name: count schema: default: 100 maximum: 10000 type: integer - description: 起始时间戳（毫秒，含） in: query name: start_time schema: format: int64 type: integer - description: 结束时间戳（毫秒，含） in: query name: end_time schema: format: int64 type: integer - description: >- 复权类型：`none`（不复权）、`forward`（前复权）、`backward`（后复权）、`forward_additive`（前复权-差值）、`backward_additive`（后复权-差值） in: query name: adjust schema: $ref: '#/components/schemas/AdjustType' responses: '200': content: application/json: schema: $ref: '#/components/schemas/KlineResponse' description: K线数据 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: schemas: Period: default: 1d description: K线周期 enum: - 1m - 5m - 15m - 30m - 60m - 1d - 1w - 1M - 1Q - 1Y type: string AdjustType: default: forward description: 复权类型 enum: - none - forward - backward - forward_additive - backward_additive type: string KlineResponse: properties: data: $ref: '#/components/schemas/CompactKlineData' required: - data type: object CompactKlineData: description: 列式OHLCV数据，传输效率高。每个数组长度相同，相同下标对应同一根K线。 properties: amount: description: 成交额 items: type: number type: array close: description: 收盘价 items: type: number type: array high: description: 最高价 items: type: number type: array low: description: 最低价 items: type: number type: array open: description: 开盘价 items: type: number type: array prev_close: description: 前收盘价（部分接口返回） items: type: number type: array timestamp: description: 时间戳（毫秒） items: format: int64 type: integer type: array volume: description: 成交量 items: format: int64 type: integer type: array required: - timestamp - open - high - low - close - volume - amount type: object ErrorResponse: description: 错误响应 properties: code: description: HTTP 状态码 type: integer message: description: 错误描述 type: string required: - code - message type: object RateLimitResponse: description: 限流响应 properties: code: example: 429 type: integer message: description: 限流说明 type: string retry_after_ms: description: 建议等待时间（毫秒） type: integer required: - code - message - retry_after_ms type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ``` -------------------------------- ### 批量获取K线数据 OpenAPI 定义 Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E6%89%B9%E9%87%8F%E8%8E%B7%E5%8F%96k%E7%BA%BF%E6%95%B0%E6%8D%AE 定义了 /v1/klines/batch 接口的请求参数、响应结构及相关数据模型。 ```yaml openapi: 3.1.0 info: contact: email: support@quantdash.net description: 提供中国A股、ETF、美股、港股的实时和历史行情数据接口 title: QuantDash version: 1.0.0 servers: - url: https://api.quantdash.net security: - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - description: 历史K线（OHLCV）数据 name: K线数据 - description: 实时报价和市场深度 name: 实时行情 - description: 日内分钟级别数据 name: 日内分时 - description: 标的元数据 name: 基础信息 paths: /v1/klines/batch: get: tags: - K线数据 summary: 批量获取K线数据 description: 一次请求获取多个标的的K线数据，响应以标的代码为 key。 operationId: getKlinesBatch parameters: - description: 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） example: 600000.SH,000001.SZ in: query name: symbols required: true schema: type: string - description: K线周期。分钟级（1m/5m/15m/30m/60m）需要分钟K线权限，日/周/月/季/年需要日K线权限。 in: query name: period schema: $ref: '#/components/schemas/Period' - description: 最大返回条数 in: query name: count schema: default: 100 maximum: 10000 type: integer - description: 起始时间戳（毫秒，含） in: query name: start_time schema: format: int64 type: integer - description: 结束时间戳（毫秒，含） in: query name: end_time schema: format: int64 type: integer - description: >- 复权类型：`none`（不复权）、`forward`（前复权）、`backward`（后复权）、`forward_additive`（前复权-差值）、`backward_additive`（后复权-差值） in: query name: adjust schema: $ref: '#/components/schemas/AdjustType' responses: '200': content: application/json: schema: $ref: '#/components/schemas/KlineBatchResponse' description: 批量K线数据 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: schemas: Period: default: 1d description: K线周期 enum: - 1m - 5m - 15m - 30m - 60m - 1d - 1w - 1M - 1Q - 1Y type: string AdjustType: default: forward description: 复权类型 enum: - none - forward - backward - forward_additive - backward_additive type: string KlineBatchResponse: description: 以标的代码为 key 的K线数据字典 properties: data: additionalProperties: $ref: '#/components/schemas/CompactKlineData' type: object required: - data type: object CompactKlineData: description: 列式OHLCV数据，传输效率高。每个数组长度相同，相同下标对应同一根K线。 properties: amount: description: 成交额 items: type: number type: array close: description: 收盘价 items: type: number type: array high: description: 最高价 items: type: number type: array low: description: 最低价 items: type: number type: array open: description: 开盘价 items: type: number type: array prev_close: description: 前收盘价（部分接口返回） items: type: number type: array timestamp: description: 时间戳（毫秒） items: format: int64 type: integer type: array volume: description: 成交量 items: format: int64 type: integer type: array required: - timestamp - open - high - low - close - volume - amount type: object ErrorResponse: description: 错误响应 properties: code: description: HTTP 状态码 type: integer message: description: 错误描述 type: string required: - code - message type: object RateLimitResponse: description: 限流响应 properties: code: example: 429 type: integer message: description: 限流说明 type: string retry_after_ms: description: 建议等待时间（毫秒） type: integer required: - code - message - retry_after_ms type: object responses: Unauthorized: content: ``` -------------------------------- ### 按时间区间批量获取K线数据 Source: https://docs.quantdash.net/zh-Hans/sdk/python-quickstart 通过 start_time 和 end_time 参数获取特定时间范围内的K线数据，时间戳需转换为毫秒级整数。 ```python import datetime from quantdash import QuantDash qd = QuantDash(api_key="your-api-key") start = int(datetime.datetime(2026, 5, 26).timestamp() * 1000) end = int(datetime.datetime(2026, 6, 1).timestamp() * 1000) dfs = qd.klines.batch(["600519.SH", "000858.SZ"], period="1d", start_time=start, end_time=end, to_dataframe=True) for sym, df in dfs.items(): print(f"--- {sym} ({df['name'].iloc[0]}) ---") print(df[["trade_date", "open", "close", "volume"]].to_string(index=False)) ``` -------------------------------- ### GET /v1/klines Source: https://docs.quantdash.net/zh-hans/api-reference/k%E7%BA%BF%E6%95%B0%E6%8D%AE/%E8%8E%B7%E5%8F%96k%E7%BA%BF%E6%95%B0%E6%8D%AE 获取单个标的的OHLCV K线数据。支持日线、周线、月线和分钟级别。数据以列式格式返回，传输效率高。 ```APIDOC ## GET /v1/klines ### Description 获取单个标的的OHLCV K线数据。支持日线、周线、月线和分钟级别。数据以列式格式返回，传输效率高。 ### Method GET ### Endpoint /v1/klines ### Parameters #### Query Parameters - **symbol** (string) - Required - 标的代码（如 `600000.SH`、`AAPL.US`、`00700.HK`） - **period** (string) - Optional - K线周期。分钟级（1m/5m/15m/30m/60m）需要分钟K线权限，日/周/月/季/年需要日K线权限。枚举值: 1m, 5m, 15m, 30m, 60m, 1d, 1w, 1M, 1Q, 1Y - **count** (integer) - Optional - 最大返回条数，默认100，最大10000 - **start_time** (integer) - Optional - 起始时间戳（毫秒，含） - **end_time** (integer) - Optional - 结束时间戳（毫秒，含） - **adjust** (string) - Optional - 复权类型：`none`（不复权）、`forward`（前复权）、`backward`（后复权）、`forward_additive`（前复权-差值）、`backward_additive`（后复权-差值） ### Response #### Success Response (200) - **data** (object) - 包含列式OHLCV数据的对象，包含 timestamp, open, high, low, close, volume, amount 数组。 ``` -------------------------------- ### 使用 Python SDK 获取行情数据 Source: https://docs.quantdash.net/zh-Hans/quickstart 通过 QuantDash Python SDK 初始化客户端并获取日 K 线及实时行情数据。 ```python from quantdash import QuantDash qd = QuantDash(api_key="your-api-key") # 获取贵州茅台日K线 df = qd.klines.get("600519.SH", period="1d", count=10, to_dataframe=True) print(df[["trade_date", "close", "volume"]]) # 获取全部 A 股实时行情 df = qd.quotes.get(universes=["CN_Stock"], to_dataframe=True) print(f"共 {len(df)} 只标的") ``` -------------------------------- ### 获取实时行情 OpenAPI 定义 Source: https://docs.quantdash.net/zh-hans/api-reference/%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85/%E8%8E%B7%E5%8F%96%E5%AE%9E%E6%97%B6%E8%A1%8C%E6%83%85 定义了获取实时行情数据的 OpenAPI 规范，包括请求参数、响应结构及错误处理机制。 ```yaml openapi: 3.1.0 info: contact: email: support@quantdash.net description: 提供中国A股、ETF、美股、港股的实时和历史行情数据接口 title: QuantDash version: 1.0.0 servers: - url: https://api.quantdash.net security: - ApiKeyHeader: [] - ApiKeyQuery: [] tags: - description: 历史K线（OHLCV）数据 name: K线数据 - description: 实时报价和市场深度 name: 实时行情 - description: 日内分钟级别数据 name: 日内分时 - description: 标的元数据 name: 基础信息 paths: /v1/quotes: get: tags: - 实时行情 summary: 获取实时行情 description: 获取最新实时报价。支持按标的代码查询或按标的池查询。两种方式二选一。 operationId: getQuotes parameters: - description: 标的代码，逗号分隔（如 `600000.SH,000001.SZ,AAPL.US`） example: 600000.SH,000001.SZ in: query name: symbols schema: type: string - description: >- 标的池ID，逗号分隔。可选值：`CN_Stock`（A股）、`US_Stock`（美股）、`HK_Stock`（港股）、`CN_ETF`（ETF） in: query name: universes schema: enum: - CN_Stock - US_Stock - HK_Stock - CN_ETF type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/QuotesResponse' description: 行情数据 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: schemas: QuotesResponse: properties: data: items: $ref: '#/components/schemas/Quote' type: array required: - data type: object Quote: description: 单个标的的实时行情快照 properties: amount: description: 成交额 type: number ext: $ref: '#/components/schemas/QuoteExt' high: description: 最高价 type: number last_price: description: 最新价 type: number low: description: 最低价 type: number open: description: 开盘价 type: number prev_close: description: 昨收价 type: number region: description: 市场地区 enum: - CN - US - HK type: string symbol: description: 标的代码 example: 600519.SH type: string timestamp: description: 行情时间戳（毫秒） format: int64 type: integer volume: description: 成交量 format: int64 type: integer required: - symbol - region - last_price - prev_close - open - high - low - volume - amount - timestamp type: object ErrorResponse: description: 错误响应 properties: code: description: HTTP 状态码 type: integer message: description: 错误描述 type: string required: - code - message type: object RateLimitResponse: description: 限流响应 properties: code: example: 429 type: integer message: description: 限流说明 type: string retry_after_ms: description: 建议等待时间（毫秒） type: integer required: - code - message - retry_after_ms type: object QuoteExt: description: 行情扩展字段（因市场而异） properties: amplitude: description: 振幅（小数） type: number change_amount: description: 涨跌额 type: number change_pct: description: 涨跌幅（小数，如 0.01 表示 1%） type: number name: description: 标的名称 type: string turnover_rate: description: 换手率（小数） type: number type: description: 标的具体类型（如 cn_equity） type: string type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: API Key 无效或缺失 Forbidden: content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 当前套餐无此功能/市场权限 RateLimited: content: application/json: schema: $ref: '#/components/schemas/RateLimitResponse' description: 请求频率超限 securitySchemes: ApiKeyHeader: description: 在请求头 X-API-Key 中传递 API Key in: header name: X-API-Key type: apiKey ApiKeyQuery: description: 在 URL 查询参数 api_key 中传递 API Key in: query name: api_key type: apiKey ``` -------------------------------- ### API 认证请求示例 Source: https://docs.quantdash.net/zh-Hans/api-reference/introduction 通过 Header 或 URL 参数进行 API 认证的示例。 ```bash curl https://api.quantdash.net/v1/quotes \ -H "X-API-Key: your-api-key" \ -G -d "symbols=600519.SH" ``` ```text https://api.quantdash.net/v1/quotes?symbols=600519.SH&api_key=your-api-key ```