核心用法
etoro-api 是连接全球知名社交交易平台 eToro 的官方程序化接口，提供从市场数据获取到实盘交易执行的完整链路。该技能支持 双环境切换（Demo 模拟盘 / Real 实盘），用户可通过申请 API Key 实现自动化策略部署。
主要功能模块
- 市场数据：实时行情、历史 K 线（最多 1000 根）、 instrument 元数据搜索
- 交易执行：市价开仓（按金额/按数量）、限价单、止损止盈设置、仓位平仓
- 组合管理：查询 PnL、交易历史、持仓明细
- 社交功能：访问关注列表、热门投资者筛选、Feeds 社交动态发布与阅读
显著优点
1. 官方背书：直接对接 eToro 官方 API，数据实时性与执行可靠性有保障
2. 零风险测试：内置 Demo 环境，支持完整交易流程的 Paper Trading
3. 社交化投资：可获取 Popular Investors 绩效数据，实现跟单策略的量化分析
4. 灵活风控：支持 TSL（追踪止损）、自定义止损止盈、部分平仓等精细操作
潜在局限
- 权限分级：Write 权限需额外申请，且 Demo/Real 环境 Key 不可混用
- 命名混乱：请求体字段大小写不统一（PascalCase / camelCase / 小写），易引发 400 错误
- 分页不一致：不同端点采用
page/pageNumber/take/offset多种分页参数，需特别注意 - 地域限制：eToro 服务受监管限制，部分地区用户无法开户或调用 API
适合人群
- 量化交易开发者（Python/JS 自动化策略）
- 社交投资分析师（追踪 Popular Investors 绩效）
- 投资组合管理工具构建者
- 希望用模拟盘验证策略后再实盘的谨慎型交易者
常规风险
| 风险类型 | 说明 |
|---------|------|
| **密钥泄露** | User Key 拥有交易权限，泄露可能导致账户资金损失 |
| **环境误用** | 将 Real Key 用于 Demo 端点或反之，会导致认证失败或意外实盘交易 |
| **杠杆风险** | API 支持最高 30 倍杠杆（依品种而定），程序化高频操作可能快速放大亏损 |
| **流动性风险** | 非美交易时段或小众品种可能出现滑点，API 返回的 `Rate` 与实际成交价存在偏差 |
| **监管合规** | 自动化交易需符合 eToro 用户协议，过度频繁请求可能触发风控限制 |
建议在正式部署前，充分使用 Demo 环境验证字段命名、分页逻辑及异常处理流程。