用途:让智能体以编程方式与用户的 eToro 账户交互,覆盖行情查询、投资组合与盈亏、自选列表、社区动态(Feeds)、用户信息分析以及交易执行。基础地址为 https://public-api.etoro.com/api/v1。
认证:需用户提供 Public API Key(application)与 User Key(账户),并选择环境(真实或虚拟/模拟)。Key 可在 eToro 的 设置 > Trading 中创建,选择环境与权限(读或写)后验证身份并复制。每次请求须带三个头:x-request-id(每请求唯一 UUID)、x-api-key、x-user-key。示例:curl -X GET "https://public-api.etoro.com/api/v1/watchlists" -H "x-request-id: <UUID>" -H "x-api-key: <PUBLIC_KEY>" -H "x-user-key: <USER_KEY>"。
主要能力:行情方面可搜索标的(GET /market-data/search,fields 必填)、获取标的元数据、价格与 K 线历史、交易所与行业参考数据;交易方面支持市价开仓(按金额或按单位)、撤销挂单、平仓(可按 positionId 部分或全部平仓)、限价(触价)单,并区分 demo 与非 demo 端点;组合方面可读取 demo/real 的持仓与盈亏、交易历史;还支持自选列表的创建、重命名、增删条目,Feeds 的读取与发帖,精选列表与推荐、热门投资者,以及用户信息与收益分析。
使用要点:查询参数中数组以逗号分隔;分页参数因端点而异(如 pageNumber/pageSize、page/pageSize、take/offset)。请求体大小写敏感:交易执行用 PascalCase(如 InstrumentID、IsBuy、Leverage),平仓用 InstrumentId,自选条目用 ItemId/ItemType/ItemRank,发帖用小驼峰。未指定参数时不要发送,例如用户未给杠杆则不传 leverage。模拟与真实端点和 Key 环境必须匹配,每个 User Key 绑定特定环境。平仓须用 positionId,不能按代码。
限制与说明:交易执行需写入权限;请先确认 Key 环境与权限,并在 demo 端点测试。响应字段大小写可能不一致(如 instrumentId 与 InstrumentID),提取 ID 时需兼容。完整响应结构与示例参见 https://api-portal.etoro.com/,MCP 服务地址为 https://api-portal.etoro.com/mcp。字段取值与支持的 interval 值以官方文档为准。