Communitygithub.com

jenul-ferdinand/etoro-skill

사용자의 실시간 eToro 계정 정보(현금, 자산, 보유 종목별 티커, 원가, 손익, 거래 내역)와 eToro 시장 데이터를 읽어와 질문에 답변합니다. 사용자가 eToro, 포트폴리오, 잔고, 보유 종목, 보유 중이거나 고려 중인 주식, ETF, 암호화폐를 언급하거나 투자 관련 의견을 물을 때 사용하세요.

etoro-skill란 무엇인가요?

이 스킬은 eToro API를 통해 사용자의 실시간 계정 데이터와 시장 정보를 읽어오는 AI 어시스턴트 기능입니다. `etoro.py` 스크립트를 실행하여 계정 자산, 현금 잔고, 투자 금액, 미실현 손익, 포지션 개수, 복사 트레이더 및 대기 주문 수 등을 USD로 출력합니다. 또한 보유 종목별 티커, 수량, 평균 매입가, 현재가, 투자 금액, 평가 금액, 손익(P/L), 손익률, 비중 등을 상세히 제공합니다. `etoro.py positions` 명령어로 개별 로트 단위 정보를 조회할 수 있으며, `etoro.py get PATH`로 시장 데이터(실시간 호가, 캔들 차트, 거래 내역)를 가져올 수 있습니다. 이 스킬은 읽기 전용(GET 요청만 가능)이며, 매매, 변경, 청산은 사용자가 eToro에서 직접 해야 합니다. 포트폴리오 분석, 비중 확인, 원가 대비 평가 손익 계산 등에 유용하며, API에서 제공하지 않는 펀더멘털이나 뉴스는 웹 검색을 통해 보완하도록 안내합니다. 제한 시간은 계정 엔드포인트 분당 60회, 시장 데이터 엔드포인트 분당 120회입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jenul-ferdinand/etoro-skill/tree/main

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

eToro

etoro.py (이 스킬의 디렉토리 내)는 eToro 공개 API를 읽습니다. GET 요청만 보내며, 거래를 체결, 변경 또는 청산할 수 없습니다. 사용자가 거래를 원할 경우 eToro에서 직접 수행해야 합니다.

답변 전

python3 <skill dir>/etoro.py를 실행하고 그 출력을 바탕으로 답변하세요. 출력은 USD로 다음을 표시합니다:

  • 자본, 현금(거래 가능 금액), 투자 금액, 미실현 손익, 포지션 수, 복사 트레이더 수, 대기 주문 수
  • 보유 종목별 행: 티커, 로트 수, 첫 매수일, 수량, 평균 매입가, 현재가, 투자 금액, 평가 금액, 손익(P/L), 손익률(P/L%), 비중(평가 금액 / 자본)

etoro.py positions는 대신 로트별로 한 행씩 출력합니다. 특정 종목을 언제 또는 어떤 가격에 매수했는지에 대한 질문에 사용하세요.

포지션 규모, 집중도, 매입 원가, 가용 현금 등의 숫자를 사용하여 질문에 답변하세요. 요청받지 않은 한 전체 테이블을 붙여넣지 마세요. API는 펀더멘털이나 뉴스를 제공하지 않으므로, 답변이 이에 의존할 경우 웹을 검색하고 무엇을 조회했는지 말하세요.

시장 데이터

etoro.py get PATH는 https://public-api.etoro.com/api/v1 하위의 모든 GET 요청을 JSON으로 출력합니다. etoro.py ids ID...는 거래 내역의 instrument ID를 티커로 변환합니다.

필요 사항PATH
티커의 Instrument 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 (각 호출은 1년 미만을 조회)

검색은 기본 주식을 먼저 반환한 후 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를 업데이트하도록 요청하세요.

관련 스킬