Communitygithub.com

jenul-ferdinand/etoro-skill

Lit le compte eToro en direct (cash, actions, historique) et les données de marché avant de répondre. À utiliser dès que l'utilisateur mentionne eToro, son portefeuille, un actif ou demande un avis d'investissement.

Qu'est-ce que etoro-skill ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor ou Codex) d’accéder en lecture seule à l’API publique d’eToro. Elle exécute des scripts Python qui récupèrent les soldes, les positions détaillées (ticker, quantité, prix de revient, P/L, poids), l’historique des transactions et les données de marché en temps réel (cours, bid/ask, bougies). L’agent utilise ces informations pour répondre de manière précise à des questions sur le portefeuille, la concentration, le cash disponible, le coût de revient ou l’évolution d’un actif. Elle ne peut pas passer d’ordres ni modifier le compte. Lorsque la réponse nécessite des fondamentaux ou des actualités, elle encourage à effectuer une recherche web en complément. La compétence gère les limites de taux (60 requêtes/min pour les endpoints compte, 120 pour les données de marché) et signale les erreurs d’authentification. Elle est conçue pour les développeurs et utilisateurs avancés qui souhaitent intégrer des données eToro dans leurs flux de travail automatisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jenul-ferdinand/etoro-skill/tree/main

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

eToro

etoro.py (dans le répertoire de cette compétence) lit l'API publique d'eToro. Il envoie uniquement des requêtes GET et ne peut pas passer, modifier ou clôturer des transactions. Si l'utilisateur souhaite effectuer une transaction, il doit le faire dans eToro.

Avant de répondre

Exécutez python3 <chemin de la compétence>/etoro.py et basez la réponse sur sa sortie. Il affiche, en USD :

  • equity, cash (disponible pour trader), investi, P/L non réalisé, et le nombre de positions, de traders copiés et d'ordres en attente
  • une ligne par titre : ticker, lots, date du premier achat, unités, prix d'ouverture moyen, prix actuel, investi, valeur, P/L, P/L% et poids (valeur / equity)

etoro.py positions affiche une ligne par lot à la place. Utilisez-le pour les questions sur quand ou à quel prix quelque chose a été acheté.

Répondez à la question en utilisant les chiffres : taille de la position, concentration, coût de revient, cash disponible. Ne recopiez pas la totalité du tableau à moins que cela ne soit demandé. L'API ne fournit ni fondamentaux ni actualités ; si la réponse en dépend, effectuez une recherche web et précisez ce que vous avez consulté.

Données de marché

etoro.py get CHEMIN affiche toute requête GET sous https://public-api.etoro.com/api/v1 au format JSON. etoro.py ids ID... convertit les identifiants d'instruments (tels qu'ils apparaissent dans l'historique des transactions) en tickers.

BesoinCHEMIN
ID d'instrument, prix et variations en % pour un ticker/market-data/search?fields=instrumentId,internalSymbolFull,displayname,currentRate,dailyPriceChange,weeklyPriceChange,monthlyPriceChange&internalSymbolFull=TSLA
Recherche par nomle même, avec displayname=Tesla à la place de internalSymbolFull
Bid/ask en direct/market-data/instruments/rates?instrumentIds=1111,1002 (max 100 IDs)
Bougies de prix/market-data/instruments/1111/history/candles/desc/OneDay/30 (intervalle OneMinute à FourHours, OneDay, OneWeek ; jusqu'à 1000)
Transactions clôturées/trading/info/trade/history?minDate=2026-01-01&pageSize=50 (chaque appel remonte à moins d'un an)

La recherche renvoie d'abord l'action, puis des variantes comme TSLA.24-7 et les options. Utilisez le ticker simple. Les champs *PriceChange sont des pourcentages (0.22 signifie 0.22%).

Limites de débit : 60 requêtes par minute pour les endpoints de compte et 120 pour les données de marché. Regroupez les ID en un seul appel lorsque l'endpoint le permet.

L'index complet de la documentation est https://api-portal.etoro.com/_llms/core-api.txt. Lisez-le avec un outil de récupération web, car curl reçoit une page de défi Cloudflare.

Erreurs

Les codes HTTP 401 ou 403 signifient que les clés dans ~/.config/etoro-skill/.env sont incorrectes ou expirées. Demandez à l'utilisateur d'en générer de nouvelles dans eToro et de mettre à jour ETORO_API_KEY et ETORO_USER_KEY.

Skills associés