批量查询实时行情
OpenAPI
/zh-Hans/api-reference/openapi.json post /v1/quotes
openapi: 3.1.0
info:
title: TickFlow 行情数据 API
description: |-
高性能行情数据服务，支持 A股、ETF、美股、港股。
## 认证方式
所有接口需要通过 `x-api-key` 请求头传递 API Key 进行认证。
## 速率限制
根据 API Key 配置的权限，可能会有请求频率和配额限制。
## 批量查询
部分接口同时支持 GET 和 POST 方法：
- **GET**: 通过 URL 参数传递，适合少量数据
- **POST**: 通过 JSON Body 传递，适合大批量查询，不受 URL 长度限制
## K线周期
支持的周期：1m, 5m, 10m, 15m, 30m, 60m, 1d, 1w, 1M, 1Q, 1Y
- 日内周期(5m/15m/30m/60m)从1m数据聚合
- 周线(1w)/月线(1M)/季线(1Q)/年线(1Y)从日线聚合
- intraday 接口当前为 Beta 版本
contact:
name: TickFlow Team
license:
name: ''
version: 1.0.0
servers:
- url: https://api.tickflow.org
security:
- api_key: []
paths:
/v1/quotes:
post:
tags:
- 实时行情
summary: 批量查询实时行情
operationId: post_quotes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QuotesRequest'
required: true
responses:
'200':
description: 查询成功
content:
application/json:
schema:
$ref: '#/components/schemas/QuotesResponse'
'400':
description: 参数错误
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: 认证失败
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 无权限
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'404':
description: 标的池不存在
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
security:
- api_key: []
components:
schemas:
QuotesRequest:
type: object
description: 实时行情批量查询请求体 (POST)
properties:
symbols:
type:
- array
- 'null'
items:
type: string
description: 标的代码列表
example:
- 600000.SH
- 000001.SZ
- AAPL.US
universes:
type:
- array
- 'null'
items:
type: string
description: 标的池 ID 列表
example:
- CN_Equity_A
- CN_ETF
QuotesResponse:
type: object
description: 实时行情响应
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/Quote'
ApiError:
type: object
description: API 错误响应体
required:
- code
- message
properties:
code:
type: string
description: 错误代码 (如 "INVALID_PERIOD", "SYMBOL_NOT_FOUND")
example: INVALID_PERIOD
details:
description: 详细信息 (可选，用于调试)
message:
type: string
description: 错误消息 (人类可读)
example: 'Invalid period: 2d'
Quote:
type: object
description: 行情数据
required:
- symbol
- region
- last_price
- prev_close
- open
- high
- low
- volume
- amount
- timestamp
properties:
amount:
type: number
format: double
description: 成交额
ext:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/QuoteExtension'
description: 扩展数据
high:
type: number
format: double
description: 最高价
last_price:
type: number
format: double
description: 最新价
low:
type: number
format: double
description: 最低价
open:
type: number
format: double
description: 开盘价
prev_close:
type: number
format: double
description: 昨收价
region:
$ref: '#/components/schemas/Region'
description: 地区
session:
oneOf:
- type: 'null'
- $ref: '#/components/schemas/SessionStatus'
description: 交易时段
symbol:
type: string
description: 标的代码
timestamp:
type: integer
format: int64
description: 时间戳 (毫秒)
volume:
type: integer
format: int64
description: 成交量
QuoteExtension:
oneOf:
- allOf:
- $ref: '#/components/schemas/CnEquityQuoteExt'
description: A股扩展数据
- type: object
required:
- type
properties:
type:
type: string
enum:
- cn_equity
description: A股扩展数据
- allOf:
- $ref: '#/components/schemas/UsEquityQuoteExt'
description: 美股扩展数据
- type: object
required:
- type
properties:
type:
type: string
enum:
- us_equity
description: 美股扩展数据
- allOf:
- $ref: '#/components/schemas/HkEquityQuoteExt'
description: 港股扩展数据
- type: object
required:
- type
properties:
type:
type: string
enum:
- hk_equity
description: 港股扩展数据
description: |-
地区特定的扩展数据
`type` 标签值与 [`MarketType`] 一一对应。
Region:
type: string
description: 支持的地区/市场
enum:
- CN
- US
- HK
SessionStatus:
type: string
description: 交易时段状态
enum:
- pre_market
- regular
- after_hours
- closed
- halted
- lunch_break
CnEquityQuoteExt:
type: object
description: A股扩展数据（仅实时/计算字段，静态字段在 Instrument）
properties:
amplitude:
type:
- number
- 'null'
format: double
description: 振幅 0.01 -> 1%
change_amount:
type:
- number
- 'null'
format: double
description: 涨跌额
change_pct:
type:
- number
- 'null'
format: double
description: 涨跌幅 0.01 -> 1%
name:
type:
- string
- 'null'
description: 名称
turnover_rate:
type:
- number
- 'null'
format: double
description: 换手率 0.01 -> 1%
UsEquityQuoteExt:
type: object
description: 美股扩展数据（与 A 股保持一致结构）
properties:
amplitude:
type:
- number
- 'null'
format: double
description: 振幅 0.01 -> 1%
change_amount:
type:
- number
- 'null'
format: double
description: 涨跌额
change_pct:
type:
- number
- 'null'
format: double
description: 涨跌幅 0.01 -> 1%
name:
type:
- string
- 'null'
description: 名称
turnover_rate:
type:
- number
- 'null'
format: double
description: 换手率 0.01 -> 1%
HkEquityQuoteExt:
type: object
description: 港股扩展数据（与 A 股 / 美股保持一致结构）
properties:
amplitude:
type:
- number
- 'null'
format: double
description: 振幅 0.01 -> 1%
change_amount:
type:
- number
- 'null'
format: double
description: 涨跌额
change_pct:
type:
- number
- 'null'
format: double
description: 涨跌幅 0.01 -> 1%
name:
type:
- string
- 'null'
description: 名称
turnover_rate:
type:
- number
- 'null'
format: double
description: 换手率 0.01 -> 1%
securitySchemes:
api_key:
type: apiKey
in: header
name: x-api-key