股票数据 API
模块: stocks
本模块包含 8 个API端点。
📋 端点列表
- ➕
POST /api/v1/stock-data- Create Stock Data - 🔍
GET /api/v1/stock-data- Get Stock Data List - 🔍
GET /api/v1/stock-data/{code}/{timestamp}- Get Stock Data - 🔍
GET /api/v1/stock-codes- Get Stock Codes - 🗑️
DELETE /api/v1/stock-data/{code}- Delete Stock Data - ➕
POST /api/v1/stock-import/import- Import Stock Data - 🔍
GET /api/v1/stock-import/import/{task_id}/status- Get Import Status - 🗑️
DELETE /api/v1/stock-import/import/{task_id}- Cancel Import Task
📖 详细说明
➕ Create Stock Data
创建股票数据
请求方式: POST /api/v1/stock-data
请求体:
// 参考模型: StockDataCreate
- `code` (string) - **必填** - 股票代码
- `open` (number) - **必填** - 开盘价
- `high` (number) - **必填** - 最高价
- `low` (number) - **必填** - 最低价
- `close` (number) - **必填** - 收盘价
- `volume` (integer) - **必填** - 成交量
- `turnover` (number) - **必填** - 成交额
- `timestamp` (integer) - **必填** - 时间戳(UNIX时间戳)
- `trade_session` (object) - **必填** - 交易时段
- 类型: `TradeSession`
响应:
错误响应:
422: Validation Error
🔍 Get Stock Data List
获取股票数据列表
请求方式: GET /api/v1/stock-data
查询参数:
code(string) - 可选 - 股票代码筛选start_date(string) - 可选 - 开始日期（ISO格式）end_date(string) - 可选 - 结束日期（ISO格式）trade_session(string) - 可选 - 交易时段筛选sort_by(string) - 可选 - 排序字段sort_order(string) - 可选 - 排序方式: asc/descpage(integer) - 可选 - 页码page_size(integer) - 可选 - 每页数量timezone(string) - 可选 - 时区
响应:
// 参考模型: StockDataResponse
- `data` (array) - **必填** - 股票数据列表
- `total` (integer) - **必填** - 总数量
- `page` (integer) - **必填** - 当前页码
- `page_size` (integer) - **必填** - 每页数量
- `total_pages` (integer) - **必填** - 总页数
错误响应:
422: Validation Error
🔍 Get Stock Data
获取单条股票数据
请求方式: GET /api/v1/stock-data/{code}/{timestamp}
路径参数:
code(string) - 必填 -timestamp(integer) - 必填 -
响应:
// 参考模型: StockData
- `code` (string) - **必填** - 股票代码
- `open` (number) - **必填** - 开盘价
- `high` (number) - **必填** - 最高价
- `low` (number) - **必填** - 最低价
- `close` (number) - **必填** - 收盘价
- `volume` (integer) - **必填** - 成交量
- `turnover` (number) - **必填** - 成交额
- `timestamp` (integer) - **必填** - 时间戳(UNIX时间戳)
- `trade_session` (object) - **必填** - 交易时段
- 类型: `TradeSession`
错误响应:
422: Validation Error
🔍 Get Stock Codes
获取所有股票代码
请求方式: GET /api/v1/stock-codes
响应:
// 参考模型: StockCodeList
- `codes` (array) - **必填** - 股票代码列表
🗑️ Delete Stock Data
删除指定时间范围内的股票数据
请求方式: DELETE /api/v1/stock-data/{code}
路径参数:
code(string) - 必填 -
查询参数:
start_date(string) - 必填 - 开始日期（ISO格式）end_date(string) - 必填 - 结束日期（ISO格式）timezone(string) - 可选 - 时区
响应:
错误响应:
422: Validation Error
➕ Import Stock Data
导入股票数据
请求方式: POST /api/v1/stock-import/import
请求体:
// 参考模型: StockImportRequest
- `symbol` (string) - **必填** - 股票代码
- `start_date` (string) - **必填** - 开始日期（ISO格式）
- `end_date` (string) - **必填** - 结束日期（ISO格式）
- `timezone` (string) - 可选 - 时区
响应:
// 参考模型: StockImportResponse
- `task_id` (string) - **必填** - 任务ID
- `message` (string) - **必填** - 响应消息
错误响应:
422: Validation Error
🔍 Get Import Status
获取导入任务状态
请求方式: GET /api/v1/stock-import/import/{task_id}/status
路径参数:
task_id(string) - 必填 -
响应:
// 参考模型: StockImportStatus
- `task_id` (string) - **必填** - 任务ID
- `status` (string) - **必填** - 任务状态
- `progress` (integer) - **必填** - 进度百分比
- `message` (string) - **必填** - 状态消息
- `data_count` (integer) - 可选 - 已获取数据条数
- `overwritten_count` (integer) - 可选 - 覆盖的数据条数
- `new_count` (integer) - 可选 - 新增的数据条数
- `filtered_count` (integer) - 可选 - 过滤掉的数据条数
- `avg_daily_count` (integer) - 可选 - 平均每天数据条数
错误响应:
422: Validation Error
🗑️ Cancel Import Task
取消导入任务
请求方式: DELETE /api/v1/stock-import/import/{task_id}
路径参数:
task_id(string) - 必填 -
响应:
错误响应:
422: Validation Error