Communitygithub.com

jenul-ferdinand/etoro-skill

讀取使用者的即時 eToro 帳戶資訊(現金、權益、各標的持有、成本基礎、損益、交易歷史)及 eToro 市場數據後再回答問題。每當使用者提及 eToro、他們的投資組合、餘額或持有部位、他們擁有或考慮中的股票、ETF 或加密貨幣,或是詢問投資想法時使用。

etoro-skill 是什麼?

此技能的主要功能是透過 eToro 公開 API 讀取使用者的即時帳戶資料與市場數據,供 AI 助手在回答 eToro 相關問題前使用。它僅能發送 GET 請求,無法執行下單、修改或平倉等交易操作。支援查詢權益、現金、已投資金額、未實現損益、各標的持有明細(包含開倉日期、單位數、平均成本、現價、損益百分比及權重),以及歷史交易記錄和即時報價(買賣價、K 線)。同時提供市場數據搜尋、價格變化百分比、K 線區間查詢等功能。使用此技能時需注意速率限制(帳戶端點每分鐘 60 次,市場數據端點每分鐘 120 次),並可批次查詢多個標的 ID。當需要基本面或新聞資訊時,技能會指示助手另外搜尋網路補足。

相容平台~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 dir>/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)
價格 K 線/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 中產生新金鑰,並更新 ETORO_API_KEY 和 ETORO_USER_KEY。

相關技能