资产管理 API
模块: assets
本模块包含 13 个API端点。
📋 端点列表
- 🔍
GET /api/v1/assets/- Get User Asset - ✏️
PUT /api/v1/assets/- Update User Asset - ➕
POST /api/v1/assets/- Create User Asset - 🗑️
DELETE /api/v1/assets/- Delete User Asset - 🔍
GET /api/v1/assets/overview- Get Asset Overview - 🔍
GET /api/v1/assets/simulated/- Get Simulated Asset - ✏️
PUT /api/v1/assets/simulated/- Update Simulated Asset - ➕
POST /api/v1/assets/simulated/- Create Simulated Asset - 🔍
GET /api/v1/assets/simulated/overview- Get Simulated Asset Overview - ➕
POST /api/v1/assets/sync- Sync From Broker - ➕
POST /api/v1/assets/sync-to-simulated- Sync To Simulated - ➕
POST /api/v1/assets/sync-from-longport- Sync From Longport - ➕
POST /api/v1/api-test/trade/account-balance- Test Account Balance
📖 详细说明
🔍 Get User Asset
获取用户资产（使用新的统一架构）
请求方式: GET /api/v1/assets/
响应:
✏️ Update User Asset
更新用户资产（使用新的统一架构）
请求方式: PUT /api/v1/assets/
请求体:
// 参考模型: UserAssetUpdate
- `total_assets` (object) - 可选 -
- `cash_assets` (object) - 可选 -
- `position_assets` (object) - 可选 -
- `today_pnl` (object) - 可选 -
- `currency` (object) - 可选 -
响应:
错误响应:
422: Validation Error
➕ Create User Asset
创建用户资产（使用新的统一架构）
请求方式: POST /api/v1/assets/
请求体:
// 参考模型: UserAssetCreate
- `user_id` (string) - **必填** - 用户ID
- `cash_assets` (object) - **必填** - 现金资产
- `currency` (object) - 可选 - 默认货币
- 类型: `CurrencyType`
响应:
// 参考模型: UserAssetResponse
- `user_id` (string) - **必填** - 用户ID
- `cash_assets` (string) - **必填** - 现金资产
- `currency` (object) - 可选 - 默认货币
- 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `id` (string) - **必填** - 资产ID
- `created_at` (string) - **必填** - 创建时间
错误响应:
422: Validation Error
🗑️ Delete User Asset
删除用户资产（使用新的统一架构）
请求方式: DELETE /api/v1/assets/
错误响应:
204: Successful Response
🔍 Get Asset Overview
获取资产概览（使用新的统一架构）
请求方式: GET /api/v1/assets/overview
查询参数:
force_refresh(boolean) - 可选 - 是否强制刷新数据
响应:
错误响应:
422: Validation Error
🔍 Get Simulated Asset
获取模拟资产（使用新的统一架构）
请求方式: GET /api/v1/assets/simulated/
响应:
✏️ Update Simulated Asset
更新模拟资产
请求方式: PUT /api/v1/assets/simulated/
请求体:
// 参考模型: SimulatedAssetUpdate
- `cash_assets` (object) - **必填** - 现金资产
- `currency` (object) - **必填** - 货币类型
- 类型: `CurrencyType`
响应:
错误响应:
422: Validation Error
➕ Create Simulated Asset
创建模拟资产（使用新的统一架构）
请求方式: POST /api/v1/assets/simulated/
请求体:
// 参考模型: SimulatedAssetCreate
- `user_id` (string) - **必填** - 用户ID
- `cash_assets` (object) - **必填** - 现金资产
- `currency` (object) - 可选 - 默认货币
- 类型: `CurrencyType`
响应:
// 参考模型: SimulatedAssetResponse
- `user_id` (string) - **必填** - 用户ID
- `cash_assets` (string) - **必填** - 现金资产
- `currency` (object) - 可选 - 默认货币
- 类型: `CurrencyType`
- `updated_at` (string) - **必填** - 更新时间
- `id` (string) - **必填** - 模拟资产ID
- `created_at` (string) - **必填** - 创建时间
错误响应:
422: Validation Error
🔍 Get Simulated Asset Overview
获取模拟资产概览（使用新的统一架构）
请求方式: GET /api/v1/assets/simulated/overview
响应:
➕ Sync From Broker
从券商同步资产数据
请求方式: POST /api/v1/assets/sync
请求体:
// 参考模型: SyncRequest
- `user_id` (string) - **必填** - 用户ID
- `broker_id` (object) - 可选 - 券商ID
响应:
// 参考模型: SyncResponse
- `success` (boolean) - **必填** - 同步结果
- `message` (string) - **必填** - 同步消息
- `synced_assets` (object) - 可选 - 同步后的资产
- `synced_positions` (object) - 可选 - 同步后的持仓
错误响应:
422: Validation Error
➕ Sync To Simulated
同步真实资产到模拟资产
请求方式: POST /api/v1/assets/sync-to-simulated
响应:
// 参考模型: SyncResponse
- `success` (boolean) - **必填** - 同步结果
- `message` (string) - **必填** - 同步消息
- `synced_assets` (object) - 可选 - 同步后的资产
- `synced_positions` (object) - 可选 - 同步后的持仓
➕ Sync From Longport
从长桥API手动同步真实资产数据（使用新的统一架构）
请求方式: POST /api/v1/assets/sync-from-longport
响应:
// 参考模型: SyncResponse
- `success` (boolean) - **必填** - 同步结果
- `message` (string) - **必填** - 同步消息
- `synced_assets` (object) - 可选 - 同步后的资产
- `synced_positions` (object) - 可选 - 同步后的持仓
➕ Test Account Balance
测试获取账户余额
请求方式: POST /api/v1/api-test/trade/account-balance
请求体:
// 参考模型: GetAccountBalanceRequest
- `currency` (object) - 可选 - 货币
响应:
// 参考模型: TradeTestResponse
- `success` (boolean) - **必填** - 是否成功
- `message` (string) - **必填** - 人类可读的结果描述
- `data` (object) - 可选 - 原始数据
- `error` (object) - 可选 - 错误信息
错误响应:
422: Validation Error