仓位管理

投资组合位于界面的右侧面板。它允许您跟踪已开仓位、基于历史资金费率数据计算真实 PnL，以及保存已平仓位的已实现 PnL 记录。

投资组合概览

面板顶部显示：

指标	说明
Value / Invested	所有仓位的当前市值或入场投资总额
Active PnL	所有已开仓位的汇总 PnL（绿色 = 盈利，红色 = 亏损）
Realized PnL	已平仓位的总 PnL
Combined	Active + Realized PnL（两者都存在时显示）

头部操作

按钮	说明
⛶ Expand	打开全屏模式，提供详细表格和每个仓位的图表
↻ Refresh	从后端重新计算所有仓位的 PnL（获取最新资金费率数据）
PnL ×	清除所有缓存的 PnL 数据（需要确认）

仓位卡片

每个仓位以卡片形式显示：

• Symbol — 标的名称（可点击——跳转至图表）
• Exchanges — 多头交易所和空头交易所
• Amount — 投资金额（$）或当前市值及价格变动（%）
• Token Quantity — 仓位中的代币数量
• Opening Cost — 开仓产生的手续费和滑点
• PnL — 当前盈亏（可点击——打开全屏模式并展开该仓位）
• Entry Date — 开仓日期

每张卡片提供编辑和删除操作。

添加仓位

从标的详情面板添加

最快的方式——在标的详情视图中点击 + Portfolio。多头和空头交易所将自动填充为当前分析的最佳配对。

仓位表单字段

字段	说明
Symbol	标的名称（只读，由扫描设置）
Long Exchange	多头交易所（下拉列表包含所有可用交易所）
Short Exchange	空头交易所（下拉列表包含所有可用交易所）
Amount ($)	每边投资金额（美元）
Token Quantity	仓位中的代币数量
Price ($)	当前代币价格（从交易所 API 或 CoinGecko 自动获取）
Opening Cost ($)	开仓成本（两家交易所的交易手续费、滑点）
Entry Date	开仓日期（最大值 = 今天）

关联字段：Amount 和 Token Quantity

Amount 和 Token Quantity 字段是关联的。修改其中一个，另一个会根据当前代币价格自动重新计算。价格从交易所 API（Binance、Bybit、OKX、Gate.io、Bitget、KuCoin、Hyperliquid）获取，CoinGecko 作为备选。

交易所验证

• 两个交易所下拉列表互斥——不能为多头和空头选择同一个交易所
• 添加模式：仅显示当前标的可用的交易所
• 编辑模式：可访问所有 27+ 家交易所

价格自动获取

当您更改多头或空头交易所时，表单会自动获取当前代币价格：

1. 并行尝试交易所特定 API（所选的多头 + 空头交易所）
2. 如果两个都返回结果：取价格平均值
3. 如果只有一个返回结果：使用该价格
4. 如果都失败：回退到 CoinGecko 搜索

编辑仓位

点击仓位卡片上的编辑图标，以编辑模式打开表单。所有字段均可编辑。点击 Save 保存更改或 Cancel 放弃修改。

Token Quantity

编辑时，更改 Amount 或 Tokens 字段会根据当前价格（而非入场价格）重新计算另一个。保存前请仔细检查数值。

更新 PnL

点击 ↻（刷新）按钮重新计算所有仓位的 PnL。更新过程：

1. 从后端获取每个仓位的历史资金费率数据（入场日期 → 当前）
2. 使用 Riemann 积分法对逐时资金费率进行积分，计算真实 PnL
3. 从交易所获取当前代币价格
4. 逐步更新缓存（每个仓位计算完成后即可看到数据）

请求之间间隔 800 毫秒以遵守速率限制。失败的请求最多重试 3 次。

完整的 PnL 公式请参阅公式与计算。

开仓成本

Opening Cost 会从 PnL 中扣除。请确保将两家交易所的交易手续费和开仓时产生的滑点都计算在内。

关闭仓位

删除仓位时：

• 仓位将移至投资组合底部的已平仓区域
• 关闭时的已实现 PnL 将被保留
• 关闭日期将被记录

已平仓区域

• 所有已平仓位的可折叠列表
• 每条记录显示：标的名称、交易所、已实现 PnL、关闭日期
• Remove from history — 删除单条已平仓记录
• Clear all history — 删除所有已平仓记录（需要确认）

已平仓位的已实现 PnL 在投资组合概览中单独显示，并计入 Combined 总额。

自动同步至 Telegram

配置 Telegram 通知后，每当仓位发生变化时，投资组合会自动同步至通知服务（通过 1.5 秒的防抖机制来批量处理快速变更）。