Portfolio 技能
觸發
- 關鍵字:Portfolio, portfolio, position, {PRIMARY_PROVIDER}, protocol, lending, staking, liquidity
何時不使用
- 一般代幣查詢(非 Portfolio 持倉)
- 交易構建(請使用對應的提供者)
- 與投資組合無關的 API 問題
核心檔案
| 類型 | 檔案 | 用途 |
|---|
| 控制器 | src/entity/portfolio/portfolio.controller.ts | REST API |
| 路由器 | src/service/portfolio/source-router/*.service.ts | 路由編排 |
| 用戶端 | src/service/portfolio/providers/{provider}/*.ts | {PRIMARY_PROVIDER} 整合 |
| 聚合器 | src/service/portfolio/aggregation/*.service.ts | 聚合計算 |
| DTO | src/dto/portfolio/position.types.ts | 持倉模型 |
API 概覽
基礎路徑:/onchain/v1/portfolio
| 端點 | 方法 | 用途 |
|---|
/positions | POST | 取得投資組合持倉 |
/chains | GET | 支援的區塊鏈清單 |
/protocols | GET | 支援的協議清單 |
輸出
- 領域特定的查詢結果,附帶程式碼參考
- 基於當前架構的分析與建議
驗證
- 持倉資料正確正規化
- 快取命中/未命中運作正常
- 聚合計算準確
開發指南
新增協議支援
- 確認 {PRIMARY_PROVIDER} 是否支援
- 如需自定義構建:實作
PortfolioPositionExtractor + 註冊 + 配置路由
新增資料來源
- 實作
ProviderClient + Adapter
- 向
SourceRouter 註冊
- 配置路由策略
除錯
redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'
參考資料
references/architecture.md - 系統架構 + 快取策略
references/api.md - API 參考 + 資料模型
- @docs/features/portfolio/ - 詳細文件
測試
| 類型 | 位置 |
|---|
| 單元測試 | test/unit/service/portfolio/ |
| 整合測試 | test/integration/portfolio/ |
範例
輸入:如何查詢投資組合持倉?
動作:解釋 POST /positions API + 路由策略
輸入:{PRIMARY_PROVIDER} 整合如何運作?
動作:解釋 {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter 流程