# TMB Portfolio API - Hermes Skill

> Skill này cho phép Hermes (AI agent cá nhân của bạn) đọc danh mục tài sản từ TheMoneyBrew.org và phân tích, tối ưu.

---
name: tmb-portfolio
description: Đọc và phân tích danh mục tài sản từ TheMoneyBrew.org qua API. Dùng khi user hỏi về tài sản, phân bổ, hoặc muốn tối ưu danh mục đầu tư.
triggers:
  - danh mục tài sản
  - portfolio của tôi
  - phân tích tài sản
  - tối ưu đầu tư
  - themoneybrew
---

# TMB Portfolio API

Base URL: `https://themoneybrew.org`

## 1. Endpoint phân tích đầy đủ (khuyến nghị dùng đầu tiên)

`GET /api/portfolio/insights` - yêu cầu API key.

```bash
curl -s "https://themoneybrew.org/api/portfolio/insights" \
  -H "Authorization: Bearer $TMB_API_KEY"
```

Trả về markdown (hoặc `?format=json`) gồm TẤT CẢ trong 1 lần gọi:
- Tổng tài sản ròng + phân bổ theo loại tài sản
- Chi tiết từng tài sản
- Hồ sơ nhà đầu tư + hồ sơ tài chính (thu nhập, chi tiêu, tiết kiệm/tháng)
- Lịch sử tài sản ròng (12 mốc gần nhất)
- Fear & Greed VN 30 ngày + xu hướng 7 ngày
- Giá USDT/VND hiện tại (Binance P2P)
- **Metrics tính sẵn**: mức tập trung tài sản, tỷ trọng tiền mặt/crypto, biến động net worth, runway tháng, cảnh báo lệch khẩu vị rủi ro

## 2. Endpoint danh mục cơ bản

`GET /api/portfolio/me` - yêu cầu API key. Trả danh mục + hồ sơ. Có `?format=markdown`.

## 3. Endpoint tính toán (KHÔNG cần API key - công thức chuẩn)

`POST /api/agent/calculate` - dùng thay vì tự chế công thức.

```bash
curl -s -X POST "https://themoneybrew.org/api/agent/calculate" \
  -H "Content-Type: application/json" \
  -d '{"task":"goal","targetAmount":1000000000,"years":10}'
```

Hỗ trợ 3 tasks: `goal` (mục tiêu), `runway` (quỹ dự phòng), `projection` (dự phóng tích sản).
Mọi tính toán trả về markdown mặc định, thêm `?format=json` để lấy JSON.

## 4. Dữ liệu cổ phiếu Việt Nam qua tvscreener

Nếu Hermes của bạn có `tvscreener` MCP server, agent có thể query thị trường chứng khoán Việt Nam trực tiếp từ TradingView Screener. Các công cụ:

- **Top tăng/giảm trong ngày**
- **Search cổ phiếu theo mã** → EPS, P/E, Beta, Market Cap, Dividend Yield
- **So sánh cổ phiếu** với 13,000+ chỉ báo kỹ thuật

Dữ liệu từ HOSE (150+ cổ phiếu), không cần API key.

## Khi phân tích

1. Gọi `/api/portfolio/insights` trước (hỏi user API key nếu chưa có trong env `TMB_API_KEY`)
2. Đọc phần "Metrics tính sẵn" - TMB đã tính mức tập trung, runway, cảnh báo
3. Kết hợp tâm lý thị trường (Fear & Greed) khi đề xuất timing
4. Nếu user hỏi về cổ phiếu VN → dùng `tvscreener` MCP tools để có giá/EPS/Beta thật
5. Cần tính toán thêm → dùng `/api/agent/calculate`, KHÔNG tự chế công thức
6. Đề xuất cụ thể bằng VND, dùng từ "gợi ý/tham khảo", KHÔNG dùng "chắc chắn/đảm bảo"
7. Nhắc user đây là phân tích tham khảo, không phải lời khuyên đầu tư

## Lưu ý bảo mật

- KHÔNG in API key ra output
- KHÔNG gửi API key đi đâu ngoài endpoint của themoneybrew.org
- Dữ liệu tài sản là riêng tư - không chia sẻ, không log