blofin-portfolio-analyst

BloFin 投资组合分析师

分析交易表现、回顾交易历史、计算盈亏指标并生成投资组合报告。

核心分析工作流

1. 投资组合快照

全面概览用户当前的投资组合状态：

1. 获取账户余额：使用 get_balance — 总权益、可用保证金、未实现盈亏
2. 获取所有持仓：使用 get_positions — 未平仓持仓及其入场价格、规模和盈亏
3. 获取当前价格：使用 get_tickers 获取每个持有品种的价格
4. 计算并展示：
   • 投资组合总价值（权益）
   • 未实现盈亏（绝对值和百分比）
   • 单个持仓明细：品种、方向、规模、入场价格、当前价格、盈亏、盈亏百分比
   • 可用保证金和保证金使用率
   • 盈利最多和亏损最多的持仓

示例提示词：

• “概览一下我的投资组合”
• “我的投资组合表现如何？”
• “我的总盈亏是多少？”

---

2. 交易历史分析

回顾过往交易并计算表现指标：

1. 获取成交记录：使用 get_fills_history — 最近执行的交易及其成交价格
2. 获取订单历史：使用 get_order_history — 所有历史订单，包括已取消的订单
3. 分析并展示：
   • 时段内的交易总数
   • 胜率（fillPnl 为正的交易数与平仓交易总数之比）
   • 平均盈利金额与平均亏损金额（盈利因子）
   • 交易最多的品种
   • 交易频率模式

get_fills_history 的参数：

参数	类型	必填	描述
instId	String	否	按品种筛选
orderId	String	否	按订单筛选
before / after	String	否	按 tradeId 分页
begin / end	String	否	按时间戳（ms）筛选
limit	String	否	上限为 100，默认值为 20

关键成交响应字段： instId、fillPrice、fillSize、fillPnl、positionSide、side、fee、ts。

示例提示词：

• “显示我过去 7 天的交易历史”
• “我交易 BTC-USDT 的胜率是多少？”
• “分析我本月的交易表现”

---

3. 盈亏明细

详细分析盈利与亏损：

1. 已实现盈亏 — 来自 get_fills_history，对所有平仓交易的 fillPnl 求和
2. 未实现盈亏 — 来自 get_positions，当前的 unrealizedPnl
3. 已支付手续费 — 来自 get_fills_history，对 fee 字段求和
4. 净盈亏 = 已实现盈亏 + 未实现盈亏 - 手续费总额
5. 展示按品种划分的盈亏表格

示例提示词：

• “按品种细分我的盈亏”
• “我支付了多少手续费？”
• “扣除手续费后，我的净利润是多少？”

---

4. 现货交易历史（如适用）

对于也交易现货市场的用户：

使用 get_fills_history 和现货专用端点：

• 端点：GET /api/v1/spot/trade/fills-history
• 需要 instType: "SPOT"

示例提示词：

• “显示我的现货交易历史”
• “比较我的现货和期货表现”

---

5. 生成表现报告

生成结构化的交易表现报告：

When asked for a report, compile data from multiple sources and present
a well-formatted summary with tables and key metrics.

报告模板：

📈 BloFin Trading Report
========================
Period: [start_date] to [end_date]

## Account Summary
- Total Equity: $XXX
- Available Balance: $XXX
- Margin Usage: XX%

## Open Positions
| Instrument | Side | Size | Entry | Current | PnL | PnL% |
|------------|------|------|-------|---------|-----|------|

## Performance Metrics
- Total Trades: XX
- Win Rate: XX%
- Average Win: $XX
- Average Loss: $XX
- Profit Factor: X.XX
- Total Fees: $XX
- Net Realized PnL: $XX

## Top Performers
- Best trade: [instrument] +$XX
- Worst trade: [instrument] -$XX

示例提示词：

• “生成本周的交易报告”
• “提供详细的表现分析”
• “总结我的交易活动”

分析指南

1. 计算盈亏时始终计入手续费 — 手续费会显著影响实际回报
2. 使用时间戳将数据筛选到用户指定的时段
3. 处理分页 — 如果记录超过 100 条，使用 before/after 参数多次请求
4. 清晰呈现数字 — 使用货币格式、百分比，并通过颜色区分盈利与亏损
5. 与入场价格比较 — 始终展示相对于入场价格的盈亏，而不只是绝对值
6. 说明数据限制 — 成交历史可能仅包含近期数据；如果请求的时段超出可用数据范围，请告知用户