🇨🇳 简体中文
🇺🇸 English
🇯🇵 日本語

交易管理 API

模块: trading

本模块包含 59 个API端点。

📋 端点列表

📖 详细说明

🔍 Get User Positions

获取用户持仓列表（使用新的统一架构）

请求方式: GET /api/v1/assets/positions

响应:

// 数组: UserPositionResponse[]
- `user_id` (string) - **必填** - 用户ID
- `symbol` (string) - **必填** - 证券代码
- `symbol_name` (string) - **必填** - 证券名称
- `asset_type` (object) - **必填** - 资产类型
  - 类型: `AssetType`
- `quantity` (string) - **必填** - 持仓数量
- `available_quantity` (string) - **必填** - 可用数量
- `cost_price` (string) - **必填** - 成本价
- `current_price` (object) - 可选 - 当前价格
- `market` (object) - **必填** - 市场类型
  - 类型: `MarketType`
- `currency` (object) - **必填** - 货币类型
  - 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `contract_multiplier` (object) - 可选 - 合约乘数（期权通常为100，股票为1）
- `option_type` (object) - 可选 - 期权类型（call/put）
- `strike_price` (object) - 可选 - 行权价
- `expiry_date` (object) - 可选 - 到期日
- `id` (string) - **必填** - 持仓ID
- `created_at` (string) - **必填** - 创建时间

➕ Create User Position

创建用户持仓（使用新的统一架构）

请求方式: POST /api/v1/assets/positions

请求体:

// 参考模型: UserPositionCreate
- `user_id` (string) - **必填** - 用户ID
- `symbol` (string) - **必填** - 证券代码
- `symbol_name` (string) - **必填** - 证券名称
- `asset_type` (object) - **必填** - 资产类型
  - 类型: `AssetType`
- `quantity` (object) - **必填** - 持仓数量
- `available_quantity` (object) - **必填** - 可用数量
- `cost_price` (object) - **必填** - 成本价
- `current_price` (object) - 可选 - 现价
- `market` (object) - **必填** - 市场
  - 类型: `MarketType`
- `currency` (object) - **必填** - 货币
  - 类型: `CurrencyType`
- `contract_multiplier` (object) - 可选 - 合约乘数
- `option_type` (object) - 可选 - 期权类型
- `strike_price` (object) - 可选 - 行权价
- `expiry_date` (object) - 可选 - 到期日

响应:

// 参考模型: UserPositionResponse
- `user_id` (string) - **必填** - 用户ID
- `symbol` (string) - **必填** - 证券代码
- `symbol_name` (string) - **必填** - 证券名称
- `asset_type` (object) - **必填** - 资产类型
  - 类型: `AssetType`
- `quantity` (string) - **必填** - 持仓数量
- `available_quantity` (string) - **必填** - 可用数量
- `cost_price` (string) - **必填** - 成本价
- `current_price` (object) - 可选 - 当前价格
- `market` (object) - **必填** - 市场类型
  - 类型: `MarketType`
- `currency` (object) - **必填** - 货币类型
  - 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `contract_multiplier` (object) - 可选 - 合约乘数（期权通常为100，股票为1）
- `option_type` (object) - 可选 - 期权类型（call/put）
- `strike_price` (object) - 可选 - 行权价
- `expiry_date` (object) - 可选 - 到期日
- `id` (string) - **必填** - 持仓ID
- `created_at` (string) - **必填** - 创建时间

错误响应:

✏️ Update User Position

更新用户持仓（使用新的统一架构）

请求方式: PUT /api/v1/assets/positions/{position_id}

路径参数:

请求体:

// 参考模型: UserPositionUpdate
- `symbol_name` (object) - 可选 - 
- `quantity` (object) - 可选 - 
- `available_quantity` (object) - 可选 - 
- `cost_price` (object) - 可选 - 
- `current_price` (object) - 可选 - 
- `currency` (object) - 可选 - 
- `contract_multiplier` (object) - 可选 - 
- `option_type` (object) - 可选 - 
- `strike_price` (object) - 可选 - 
- `expiry_date` (object) - 可选 -

响应:

错误响应:

🗑️ Delete User Position

删除用户持仓（使用新的统一架构）

请求方式: DELETE /api/v1/assets/positions/{position_id}

路径参数:

错误响应:

🔍 Get Simulated Positions

获取模拟持仓列表

请求方式: GET /api/v1/assets/simulated/positions

响应:

// 数组: SimulatedPositionResponse[]
- `user_id` (string) - **必填** - 用户ID
- `symbol` (string) - **必填** - 证券代码
- `symbol_name` (string) - **必填** - 证券名称
- `asset_type` (object) - **必填** - 资产类型
  - 类型: `AssetType`
- `quantity` (string) - **必填** - 持仓数量
- `cost_price` (string) - **必填** - 成本价
- `current_price` (object) - 可选 - 当前价格
- `market` (object) - **必填** - 市场类型
  - 类型: `MarketType`
- `currency` (object) - **必填** - 货币类型
  - 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `contract_multiplier` (object) - 可选 - 合约乘数（期权通常为100，股票为1）
- `option_type` (object) - 可选 - 期权类型（call/put）
- `strike_price` (object) - 可选 - 行权价
- `expiry_date` (object) - 可选 - 到期日
- `id` (string) - **必填** - 模拟持仓ID
- `created_at` (string) - **必填** - 创建时间

➕ Create Simulated Position

创建模拟持仓

请求方式: POST /api/v1/assets/simulated/positions

请求体:

// 参考模型: SimulatedPositionInput
- `symbol` (string) - **必填** - 
- `symbol_name` (string) - **必填** - 
- `quantity` (object) - **必填** - 
- `cost_price` (object) - **必填** - 
- `current_price` (object) - 可选 - 
- `market` (object) - **必填** - 
  - 类型: `MarketType`
- `currency` (object) - **必填** - 
  - 类型: `CurrencyType`

响应:

// 参考模型: SimulatedPositionResponse
- `user_id` (string) - **必填** - 用户ID
- `symbol` (string) - **必填** - 证券代码
- `symbol_name` (string) - **必填** - 证券名称
- `asset_type` (object) - **必填** - 资产类型
  - 类型: `AssetType`
- `quantity` (string) - **必填** - 持仓数量
- `cost_price` (string) - **必填** - 成本价
- `current_price` (object) - 可选 - 当前价格
- `market` (object) - **必填** - 市场类型
  - 类型: `MarketType`
- `currency` (object) - **必填** - 货币类型
  - 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `contract_multiplier` (object) - 可选 - 合约乘数（期权通常为100，股票为1）
- `option_type` (object) - 可选 - 期权类型（call/put）
- `strike_price` (object) - 可选 - 行权价
- `expiry_date` (object) - 可选 - 到期日
- `id` (string) - **必填** - 模拟持仓ID
- `created_at` (string) - **必填** - 创建时间

错误响应:

✏️ Update Simulated Position

更新模拟持仓

请求方式: PUT /api/v1/assets/simulated/positions/{position_id}

路径参数:

请求体:

// 参考模型: SimulatedPositionUpdate
- `symbol_name` (object) - 可选 - 
- `quantity` (object) - 可选 - 
- `cost_price` (object) - 可选 - 
- `current_price` (object) - 可选 - 
- `currency` (object) - 可选 - 
- `contract_multiplier` (object) - 可选 - 
- `option_type` (object) - 可选 - 
- `strike_price` (object) - 可选 - 
- `expiry_date` (object) - 可选 -

响应:

错误响应:

🗑️ Delete Simulated Position

删除模拟持仓

请求方式: DELETE /api/v1/assets/simulated/positions/{position_id}

路径参数:

错误响应:

➕ Test Today Orders

测试获取当日订单

请求方式: POST /api/v1/api-test/trade/today-orders

请求体:

// 参考模型: GetOrdersRequest
- `symbol` (object) - 可选 - 股票代码
- `status` (object) - 可选 - 订单状态
- `side` (object) - 可选 - 买卖方向
- `market` (object) - 可选 - 市场
- `order_id` (object) - 可选 - 订单ID

响应:

// 参考模型: TradeTestResponse
- `success` (boolean) - **必填** - 是否成功
- `message` (string) - **必填** - 人类可读的结果描述
- `data` (object) - 可选 - 原始数据
- `error` (object) - 可选 - 错误信息

错误响应:

➕ Test History Orders

测试获取历史订单

请求方式: POST /api/v1/api-test/trade/history-orders

请求体:

// 参考模型: GetHistoryOrdersRequest
- `symbol` (object) - 可选 - 股票代码
- `status` (object) - 可选 - 订单状态
- `side` (object) - 可选 - 买卖方向
- `market` (object) - 可选 - 市场
- `start_at` (object) - 可选 - 开始时间
- `end_at` (object) - 可选 - 结束时间

响应:

// 参考模型: TradeTestResponse
- `success` (boolean) - **必填** - 是否成功
- `message` (string) - **必填** - 人类可读的结果描述
- `data` (object) - 可选 - 原始数据
- `error` (object) - 可选 - 错误信息

错误响应:

➕ Create Trading Session

创建交易会话

请求方式: POST /api/v1/trading/sessions

请求体:

// 参考模型: TradingSessionCreate
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `initial_capital` (object) - **必填** - 期初总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `start_date` (object) - 可选 - 回测开始时间
- `end_date` (object) - 可选 - 回测结束时间
- `timezone` (string) - 可选 - 时区
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `config` (object) - **必填** - 多通道配置(必填)
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

🔍 Get Trading Sessions

获取交易会话列表

请求方式: GET /api/v1/trading/sessions

查询参数:

响应:

// 数组: TradingSessionResponse[]
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

🔍 Get Trading Session

获取交易会话详情

请求方式: GET /api/v1/trading/sessions/{session_id}

路径参数:

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

✏️ Update Trading Session

更新交易会话

请求方式: PUT /api/v1/trading/sessions/{session_id}

路径参数:

请求体:

// 参考模型: TradingSessionUpdate
- `session_name` (object) - 可选 - 会话名称
- `status` (object) - 可选 - 会话状态
- `risk_config` (object) - 可选 - 风险配置

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

🗑️ Delete Trading Session

删除交易会话

请求方式: DELETE /api/v1/trading/sessions/{session_id}

路径参数:

响应:

错误响应:

➕ Start Trading Session

启动交易会话

请求方式: POST /api/v1/trading/sessions/{session_id}/start

路径参数:

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

➕ Stop Trading Session

停止交易会话

请求方式: POST /api/v1/trading/sessions/{session_id}/stop

路径参数:

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

➕ Pause Trading Session

暂停交易会话

请求方式: POST /api/v1/trading/sessions/{session_id}/pause

路径参数:

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

➕ Resume Trading Session

恢复交易会话

请求方式: POST /api/v1/trading/sessions/{session_id}/resume

路径参数:

响应:

// 参考模型: TradingSessionResponse
- `id` (string) - **必填** - 会话ID
- `user_id` (string) - **必填** - 用户ID
- `session_name` (string) - **必填** - 会话名称
- `trading_mode` (object) - **必填** - 交易模式
  - 类型: `TradingMode`
- `asset_mode` (object) - **必填** - 资产模式
  - 类型: `AssetMode`
- `strategy_name` (string) - **必填** - 策略名称
- `status` (object) - **必填** - 会话状态
  - 类型: `SessionStatus`
- `start_time` (object) - 可选 - 开始时间
- `end_time` (object) - 可选 - 结束时间
- `initial_capital` (string) - **必填** - 期初总资产
- `final_capital` (object) - 可选 - 期末总资产
- `initial_capital_by_currency` (object) - 可选 - 按货币分组的期初总资产
- `final_capital_by_currency` (object) - 可选 - 按货币分组的期末总资产
- `config` (object) - **必填** - 配置信息
- `strategy_params` (object) - 可选 - 策略参数
- `tradable_symbols` (object) - 可选 - 可交易股票列表
- `performance_metrics` (object) - 可选 - 性能指标
- `strategy_template_id` (object) - 可选 - 策略模板ID
- `strategy_version` (object) - 可选 - 策略版本号
- `created_at` (string) - **必填** - 创建时间
- `updated_at` (string) - **必填** - 更新时间

错误响应:

➕ Create Trading Order

创建交易订单

请求方式: POST /api/v1/trading/orders

请求体:

// 参考模型: TradingOrderCreate
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (object) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `trading_fee` (object) - 可选 - 交易费用明细

响应:

// 参考模型: TradingOrderResponse
- `id` (string) - **必填** - 订单ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (string) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `status` (object) - **必填** - 订单状态
  - 类型: `OrderStatus`
- `submitted_at` (string) - **必填** - 提交时间
- `filled_at` (object) - 可选 - 成交时间
- `cancelled_at` (object) - 可选 - 取消时间
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (string) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

错误响应:

🔍 Get Trading Order

获取交易订单详情

请求方式: GET /api/v1/trading/orders/{order_id}

路径参数:

响应:

// 参考模型: TradingOrderResponse
- `id` (string) - **必填** - 订单ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (string) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `status` (object) - **必填** - 订单状态
  - 类型: `OrderStatus`
- `submitted_at` (string) - **必填** - 提交时间
- `filled_at` (object) - 可选 - 成交时间
- `cancelled_at` (object) - 可选 - 取消时间
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (string) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

错误响应:

✏️ Update Trading Order

更新交易订单

请求方式: PUT /api/v1/trading/orders/{order_id}

路径参数:

请求体:

// 参考模型: TradingOrderUpdate
- `status` (object) - 可选 - 订单状态
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (object) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

响应:

// 参考模型: TradingOrderResponse
- `id` (string) - **必填** - 订单ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (string) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `status` (object) - **必填** - 订单状态
  - 类型: `OrderStatus`
- `submitted_at` (string) - **必填** - 提交时间
- `filled_at` (object) - 可选 - 成交时间
- `cancelled_at` (object) - 可选 - 取消时间
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (string) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

错误响应:

➕ Cancel Trading Order

取消交易订单

请求方式: POST /api/v1/trading/orders/{order_id}/cancel

路径参数:

响应:

错误响应:

🔍 Get Session Orders

获取会话订单列表

请求方式: GET /api/v1/trading/sessions/{session_id}/orders

路径参数:

查询参数:

响应:

// 数组: TradingOrderResponse[]
- `id` (string) - **必填** - 订单ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (string) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `status` (object) - **必填** - 订单状态
  - 类型: `OrderStatus`
- `submitted_at` (string) - **必填** - 提交时间
- `filled_at` (object) - 可选 - 成交时间
- `cancelled_at` (object) - 可选 - 取消时间
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (string) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

错误响应:

🔍 Get Session Positions

获取会话持仓记录列表

请求方式: GET /api/v1/trading/sessions/{session_id}/positions

路径参数:

查询参数:

响应:

// 数组: PositionHistoryResponse[]
- `id` (string) - **必填** - 记录ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `quantity` (string) - **必填** - 数量
- `avg_price` (string) - **必填** - 平均价格
- `market_value` (string) - **必填** - 市值
- `unrealized_pnl` (string) - **必填** - 未实现盈亏
- `realized_pnl` (string) - **必填** - 已实现盈亏
- `timestamp` (string) - **必填** - 时间戳

错误响应:

🔍 Get Latest Positions

获取最新持仓快照

请求方式: GET /api/v1/trading/sessions/{session_id}/positions/latest

路径参数:

响应:

错误响应:

🔍 Get Session Logs

获取会话策略日志

请求方式: GET /api/v1/trading/sessions/{session_id}/logs

路径参数:

查询参数:

响应:

错误响应:

➕ Submit Simulation Order

提交模拟交易订单

请求方式: POST /api/v1/trading/simulation/orders

请求体:

// 参考模型: TradingOrderCreate
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (object) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `trading_fee` (object) - 可选 - 交易费用明细

响应:

// 参考模型: TradingOrderResponse
- `id` (string) - **必填** - 订单ID
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (string) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `status` (object) - **必填** - 订单状态
  - 类型: `OrderStatus`
- `submitted_at` (string) - **必填** - 提交时间
- `filled_at` (object) - 可选 - 成交时间
- `cancelled_at` (object) - 可选 - 取消时间
- `filled_price` (object) - 可选 - 成交价格
- `filled_quantity` (object) - 可选 - 成交数量
- `commission` (string) - 可选 - 手续费
- `trading_fee` (object) - 可选 - 交易费用明细

错误响应:

🔍 Get Session Performance

获取会话性能指标

请求方式: GET /api/v1/trading/sessions/{session_id}/performance

路径参数:

响应:

错误响应:

➕ Validate Order Risk

验证订单风险

请求方式: POST /api/v1/trading/orders/validate

请求体:

// 参考模型: TradingOrderCreate
- `session_id` (string) - **必填** - 会话ID
- `symbol` (string) - **必填** - 股票代码
- `side` (object) - **必填** - 订单方向
  - 类型: `OrderSide`
- `order_type` (object) - **必填** - 订单类型
  - 类型: `OrderType`
- `quantity` (object) - **必填** - 数量
- `price` (object) - 可选 - 价格
- `trading_fee` (object) - 可选 - 交易费用明细

响应:

错误响应:

🔍 Get Trading Engine Status

获取交易引擎状态

请求方式: GET /api/v1/trading/sessions/{session_id}/engine/status

路径参数:

响应:

错误响应:

🔍 Get Session Risk Summary

获取会话风险摘要

请求方式: GET /api/v1/trading/sessions/{session_id}/risk/summary

路径参数:

响应:

错误响应:

🔍 Get Session Risk Events

获取会话风险事件

请求方式: GET /api/v1/trading/sessions/{session_id}/risk/events

路径参数:

查询参数:

响应:

错误响应:

🔍 Get Session Risk Recommendations

获取会话风险建议

请求方式: GET /api/v1/trading/sessions/{session_id}/risk/recommendations

路径参数:

响应:

错误响应:

➕ Reset Session Daily Risk Metrics

重置会话日度风险指标

请求方式: POST /api/v1/trading/sessions/{session_id}/risk/reset-daily

路径参数:

响应:

错误响应:

🔍 Get Session Summary

T032/T036: 获取会话汇总信息（包含多通道聚合数据）

请求方式: GET /api/v1/channels/sessions/{session_id}/summary

路径参数:

响应:

// 参考模型: SessionSummaryResponse
- `session_id` (string) - **必填** - 
- `user_id` (string) - **必填** - 
- `status` (string) - **必填** - 
- `total_pnl` (number) - **必填** - 
- `total_capital` (number) - **必填** - 
- `capital_used` (number) - **必填** - 
- `total_trades` (integer) - **必填** - 
- `weighted_win_rate` (number) - **必填** - 
- `channel_count` (integer) - **必填** - 
- `running_channels` (integer) - **必填** - 
- `total_orders` (integer) - **必填** - 
- `pending_orders` (integer) - **必填** - 
- `executed_orders` (integer) - **必填** -

错误响应:

🔍 Get Risk Status

获取多通道风险状态

请求方式: GET /api/v1/channels/sessions/{session_id}/risk-status

路径参数:

响应:

错误响应:

🔍 Get Performance

获取多通道性能对比数据

请求方式: GET /api/v1/channels/sessions/{session_id}/performance

路径参数:

查询参数:

响应:

错误响应:

🔍 Get Positions

获取多通道虚拟持仓

请求方式: GET /api/v1/channels/sessions/{session_id}/positions

路径参数:

响应:

错误响应:

🔍 List Channels

T033: 获取会话的所有通道列表

请求方式: GET /api/v1/channels/sessions/{session_id}/channels

路径参数:

响应:

// 参考模型: ChannelListResponse
- `session_id` (string) - **必填** - 
- `channels` (array) - **必填** - 
- `total_channels` (integer) - **必填** - 
- `running_channels` (integer) - **必填** -

错误响应:

🔍 Get Channel Status

T033/T034: 获取单个通道的详细状态

请求方式: GET /api/v1/channels/sessions/{session_id}/channels/{channel_id}

路径参数:

响应:

// 参考模型: ChannelStatusResponse
- `channel_id` (string) - **必填** - 
- `channel_type` (string) - **必填** - 
- `status` (string) - **必填** - 
- `capital_allocation` (number) - **必填** - 
- `metrics` (object) - **必填** - 
- `strategy_count` (integer) - **必填** - 
- `started_at` (object) - **必填** - 
- `error_message` (object) - **必填** -

错误响应:

➕ Start Channel

T033: 启动指定通道

请求方式: POST /api/v1/channels/sessions/{session_id}/channels/{channel_id}/start

路径参数:

响应:

错误响应:

➕ Stop Channel

T033: 停止指定通道

请求方式: POST /api/v1/channels/sessions/{session_id}/channels/{channel_id}/stop

路径参数:

响应:

错误响应:

➕ Pause Channel

T033: 暂停指定通道

请求方式: POST /api/v1/channels/sessions/{session_id}/channels/{channel_id}/pause

路径参数:

响应:

错误响应:

➕ Resume Channel

T033: 恢复指定通道

请求方式: POST /api/v1/channels/sessions/{session_id}/channels/{channel_id}/resume

路径参数:

响应:

错误响应:

🔍 Get Channel Metrics

T034/T036: 获取通道性能指标

请求方式: GET /api/v1/channels/sessions/{session_id}/channels/{channel_id}/metrics

路径参数:

响应:

// 参考模型: ChannelMetricsResponse
- `channel_id` (string) - **必填** - 
- `timestamp` (string) - **必填** - 
- `total_pnl` (number) - **必填** - 
- `realized_pnl` (number) - **必填** - 
- `unrealized_pnl` (number) - **必填** - 
- `daily_pnl` (number) - **必填** - 
- `current_drawdown` (number) - **必填** - 
- `total_trades` (integer) - **必填** - 
- `winning_trades` (integer) - **必填** - 
- `losing_trades` (integer) - **必填** - 
- `win_rate` (number) - **必填** - 
- `active_positions` (integer) - **必填** - 
- `capital_used` (number) - **必填** - 
- `available_capital` (number) - **必填** -

错误响应:

🔍 Get Channels Breakdown

T034/T036: 获取所有通道的指标分解对比

请求方式: GET /api/v1/channels/sessions/{session_id}/channels/breakdown

路径参数:

响应:

错误响应:

✏️ Update Channel Risk Limits

T037: 热更新通道风险限制

请求方式: PUT /api/v1/channels/sessions/{session_id}/channels/{channel_id}/risk-limits

路径参数:

请求体:

// 参考模型: ChannelRiskLimitUpdate
- `max_drawdown` (object) - 可选 - 
- `max_daily_loss` (object) - 可选 - 
- `max_loss_per_trade` (object) - 可选 - 
- `leverage_limit` (object) - 可选 -

响应:

错误响应:

➕ Rollback Config

T037: 回滚配置到指定版本

请求方式: POST /api/v1/channels/sessions/{session_id}/config/rollback

路径参数:

查询参数:

响应:

错误响应:

🔍 Get Channel Risk Report

T038: 获取通道风险报告

请求方式: GET /api/v1/channels/sessions/{session_id}/channels/{channel_id}/risk-report

路径参数:

响应:

// 参考模型: RiskReportResponse
- `channel_id` (string) - **必填** - 
- `timestamp` (string) - **必填** - 
- `daily_pnl` (number) - **必填** - 
- `current_drawdown` (number) - **必填** - 
- `trades_count` (integer) - **必填** - 
- `risk_utilization` (object) - **必填** - 
- `is_halted` (boolean) - **必填** - 
- `warnings` (array) - **必填** -

错误响应:

🔍 Get All Risk Reports

T038: 获取所有通道的风险报告

请求方式: GET /api/v1/channels/sessions/{session_id}/risk-reports

路径参数:

响应:

错误响应:

🔍 Get Alert Summary

T038: 获取告警摘要

请求方式: GET /api/v1/channels/sessions/{session_id}/alerts/summary

路径参数:

响应:

// 参考模型: AlertSummaryResponse
- `session_id` (string) - **必填** - 
- `total_alerts` (integer) - **必填** - 
- `unacknowledged_alerts` (integer) - **必填** - 
- `alerts_by_level` (object) - **必填** - 
- `alerts_by_type` (object) - **必填** - 
- `recent_critical_alerts_24h` (integer) - **必填** -

错误响应:

🔍 Get Alerts

T038: 获取告警列表

请求方式: GET /api/v1/channels/sessions/{session_id}/alerts

路径参数:

查询参数:

响应:

错误响应:

➕ Acknowledge Alert

T038: 确认告警

请求方式: POST /api/v1/channels/sessions/{session_id}/alerts/{alert_id}/acknowledge

路径参数:

响应:

错误响应:

🔍 Get Session Risk Summary

获取会话风险摘要

请求方式: GET /api/v1/risk/sessions/{session_id}/summary

路径参数:

响应:

// 参考模型: RiskSummaryResponse
- `user_id` (string) - **必填** - 
- `risk_config` (object) - **必填** - 
- `daily_turnover` (number) - **必填** - 
- `daily_pnl` (number) - **必填** - 
- `current_drawdown` (number) - **必填** - 
- `max_portfolio_value` (number) - **必填** - 
- `risk_events_count` (integer) - **必填** - 
- `last_risk_event` (object) - 可选 -

错误响应:

🔍 Get Session Risk Events

获取会话风险事件

请求方式: GET /api/v1/risk/sessions/{session_id}/events

路径参数:

查询参数:

响应:

错误响应:

➕ Reset Session Daily Risk Metrics

重置会话日度风险指标

请求方式: POST /api/v1/risk/sessions/{session_id}/reset-daily

路径参数:

响应:

错误响应:

🔍 Get Session Risk Recommendations

获取会话风险建议

请求方式: GET /api/v1/risk/sessions/{session_id}/recommendations

路径参数:

响应:

错误响应:

✏️ Update Session Risk Config

更新会话风险配置

请求方式: PUT /api/v1/risk/sessions/{session_id}/config

路径参数:

请求体:

// 参考模型: RiskConfigRequest
- `config` (object) - **必填** -

响应:

错误响应: