投资组合技能
触发条件
- 关键词:投资组合, portfolio, 持仓, position, {PRIMARY_PROVIDER}, 协议, 借贷, 质押, 流动性
何时不使用
- 通用代币查询(非投资组合持仓)
- 交易构建(使用相应提供商)
- 非投资组合相关的 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 流程