eToro
etoro.py (no diretório deste skill) lê a API pública da eToro. Ele envia apenas requisições GET e não pode abrir, alterar ou fechar negociações. Se o usuário quiser negociar, deve fazê-lo na eToro.
Antes de responder
Execute python3 <diretório do skill>/etoro.py e baseie a resposta em sua saída. Ele imprime, em USD:
- patrimônio líquido, saldo disponível para negociação, investido, lucro/prejuízo não realizado e contagens de posições, copiadores e ordens pendentes
- uma linha por posição: ticker, lotes, data da primeira compra, unidades, preço médio de abertura, preço atual, investido, valor, lucro/prejuízo, % de lucro/prejuízo e peso (valor / patrimônio líquido)
etoro.py positions imprime uma linha por lote. Use para perguntas sobre quando ou a que preço algo foi comprado.
Responda à pergunta usando os números: tamanho da posição, concentração, custo médio, saldo disponível. Não cole a tabela inteira de volta a menos que solicitado. A API não fornece fundamentos ou notícias; portanto, quando a resposta depender disso, pesquise na web e informe o que consultou.
Dados de mercado
etoro.py get CAMINHO imprime qualquer GET sob https://public-api.etoro.com/api/v1 como JSON. etoro.py ids ID... converte IDs de instrumentos (como no histórico de negociações) em tickers.
| Necessidade | CAMINHO |
|---|---|
| ID do instrumento, preço e variações percentuais para um ticker | /market-data/search?fields=instrumentId,internalSymbolFull,displayname,currentRate,dailyPriceChange,weeklyPriceChange,monthlyPriceChange&internalSymbolFull=TSLA |
| Pesquisar por nome | o mesmo, com displayname=Tesla no lugar de internalSymbolFull |
| Bid/ask ao vivo | /market-data/instruments/rates?instrumentIds=1111,1002 (máx. 100 IDs) |
| Velas de preço | /market-data/instruments/1111/history/candles/desc/OneDay/30 (intervalo OneMinute a FourHours, OneDay, OneWeek; até 1000) |
| Negociações fechadas | /trading/info/trade/history?minDate=2026-01-01&pageSize=50 (cada chamada cobre menos de um ano) |
A busca retorna a ação primeiro, depois variantes como TSLA.24-7 e opções. Use o ticker simples. Os campos *PriceChange são percentuais (0,22 significa 0,22%).
Limites de taxa: 60 requisições por minuto para endpoints de conta e 120 para dados de mercado. Agrupe IDs em uma única chamada quando o endpoint permitir.
O índice completo da documentação está em https://api-portal.etoro.com/_llms/core-api.txt. Leia-o com uma ferramenta de busca web, pois o curl recebe uma página de desafio do Cloudflare.
Erros
HTTP 401 ou 403 significa que as chaves em ~/.config/etoro-skill/.env estão incorretas ou expiradas. Peça ao usuário para gerar novas na eToro e atualizar ETORO_API_KEY e ETORO_USER_KEY.