Communitygithub.com

jenul-ferdinand/etoro-skill

读取用户实时 eToro 账户信息(现金、权益、持仓按代码、成本基础、盈亏、交易历史)和 eToro 市场数据后回答问题。当用户提到 eToro、他们的投资组合、余额或持仓、他们拥有或正在考虑的股票、ETF 或加密货币,或请求投资建议时使用。

etoro-skill 是什么?

该技能提供了一个 AI 代理工具,用于从公共 eToro API 读取用户实时账户和市场数据,以便在回答投资相关问题时使用。它仅执行 GET 请求,无法下单、更改或关闭交易,确保其作为只读助手的安全角色。技能支持账户查询(权益、现金、持仓明细、每手盈亏)和市场数据检索(价格蜡烛图、实时买卖价、历史交易、代码查询),并内置了 API 端点和请求限速指南。通过本地运行的 Python 脚本 (`etoro.py`),代理可以在回答前提取数据并用数字(如仓位大小、集中度、成本基础、现金余额)回复用户,无需返回完整表格。适用于 Cursor、Claude Code 等支持自定义技能的 AI 编码代理,帮助用户在 eToro 语境下做出明智决策。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jenul-ferdinand/etoro-skill/tree/main

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

eToro

etoro.py(位于本技能目录)读取 eToro 公共 API。它仅发送 GET 请求,无法下单、修改或关闭交易。如果用户想要交易,需自行在 eToro 中操作。

回答前

运行 python3 <skill 目录>/etoro.py,并以输出为基础作答。输出内容(以美元计):

  • 权益、现金(可交易资金)、已投资额、未实现盈亏,以及持仓数、复制交易者数和待处理订单数
  • 每行一个持仓:代码、批次、首次买入日期、数量、平均开仓价、当前价格、已投资额、价值、盈亏、盈亏百分比、权重(价值 / 权益)

etoro.py positions 每行输出一个批次。用于询问何时或以何价格买入的问题。

使用数字(仓位大小、集中度、成本基础、可用现金)回答问题。除非用户要求,否则不要粘贴整张表格。API 不含基本面或新闻数据,因此当答案依赖这些信息时,搜索网络并说明已查询的内容。

市场数据

etoro.py get PATH 将 https://public-api.etoro.com/api/v1 下的任何 GET 请求以 JSON 格式打印。etoro.py ids ID... 将工具 ID(如交易历史中的)转换为股票代码。

需求PATH
某个代码的工具 ID、价格和百分比变化/market-data/search?fields=instrumentId,internalSymbolFull,displayname,currentRate,dailyPriceChange,weeklyPriceChange,monthlyPriceChange&internalSymbolFull=TSLA
按名称搜索同上,将 internalSymbolFull 替换为 displayname=Tesla
实时买卖价/market-data/instruments/rates?instrumentIds=1111,1002(最多 100 个 ID)
价格蜡烛图/market-data/instruments/1111/history/candles/desc/OneDay/30(间隔 OneMinute 到 FourHours、OneDay、OneWeek;最多 1000 条)
已平仓交易/trading/info/trade/history?minDate=2026-01-01&pageSize=50(每次调用回溯不超过一年)

搜索返回股票优先,然后是其变体如 TSLA.24-7 和期权。使用普通股票代码。*PriceChange 字段为百分比(0.22 表示 0.22%)。

速率限制:账户端点每分钟 60 次请求,市场数据每分钟 120 次。在端点允许的情况下,将 ID 合并到一次调用中。

完整文档索引位于 https://api-portal.etoro.com/_llms/core-api.txt。使用网络获取工具阅读,因为 curl 会收到 Cloudflare 验证页面。

错误

HTTP 401 或 403 表示 ~/.config/etoro-skill/.env 中的密钥错误或已过期。请用户生成新的密钥并更新 ETORO_API_KEY 和 ETORO_USER_KEY。

相关技能