Repolode
deepentropy

deepentropy/tvscreener

Biblioteca Python não oficial que obtém dados de screeners de ações, cripto, forex, títulos, futuros e outros do TradingView e os carrega em DataFrames do Pandas.

Alternativa open source a:TradingView

Estrelas
1,723
Forks
242
Issues abertas
0
Último commit
há 6 dias

Esta página apresenta um projeto de código aberto e não constitui aconselhamento de investimento. Negociar e investir pode gerar perdas: avalie o risco por conta própria e siga as leis do seu país antes de usá-lo.

O que é?

tvscreener é um cliente Python para os dados de screener do TradingView. Ele permite executar screeners de ações, ETFs, cripto, forex, títulos, futuros, moedas, índices e indicadores econômicos, filtrá-los por campos, mercados e países e receber os resultados em um DataFrame do Pandas.

Além das consultas básicas, a biblioteca inclui presets integrados do TradingView, como maiores altas e baixas, calendários de resultados, dividendos, IPOs e eventos econômicos, demonstrações financeiras de vários anos, cotações em tempo real, notícias, documentos regulatórios e transcrições de teleconferências de resultados. Ela também oferece filtros OR e aninhados, uma API fluente de select/where, busca de campos e presets de campos selecionados, além de um modo de streaming que atualiza os resultados em intervalos definidos.

O projeto não é oficial nem afiliado ao TradingView. Ele também inclui um servidor MCP para que assistentes de IA possam chamar suas ferramentas e um gerador de código baseado na web para criar consultas de screener visualmente.

Recursos principais

  • 01Screeners de ações, ETFs, cripto, forex, títulos, futuros, moedas, índices e indicadores econômicos
  • 02Filtros OR e aninhados, com operadores como has() e above_pct()
  • 03Demonstrações financeiras, eventos corporativos e retornos sazonais de símbolos
  • 04Cotações em tempo real transmitidas pelo TradingView
  • 05Consulta de notícias, documentos regulatórios e transcrições de teleconferências de resultados
  • 06Resultados em DataFrames do Pandas, com streaming e atualização automática

Casos de uso

  • Filtrar ações por critérios de valuation, dividendos ou momentum em um notebook Jupyter
  • Monitorar ativos de cripto ou forex em movimento com atualizações periódicas
  • Obter demonstrações financeiras e calendários de resultados para pesquisas
  • Dar acesso a dados de screener para assistentes de IA por meio do servidor MCP

Início rápido

  1. 1

    Instale a biblioteca pelo PyPI

    pip install tvscreener
  2. 2

    Importe a biblioteca e execute uma consulta básica do Stock Screener

    python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

Antes de usar

  • Esta é uma biblioteca de terceiros não oficial e não afiliada à TradingView.
  • O uso está sujeito aos termos de serviço da TradingView e pode deixar de funcionar se a TradingView alterar os dados.

Tópicos

Perguntas frequentes

O que é tvscreener?
Biblioteca Python não oficial que obtém dados de screeners de ações, cripto, forex, títulos, futuros e outros do TradingView e os carrega em DataFrames do Pandas. tvscreener é um cliente Python para os dados de screener do TradingView. Ele permite executar screeners de ações, ETFs, cripto, forex, títulos, futuros, moedas, índices e indicadores econômicos, filtrá-los por campos, mercados e países e receber os resultados em um DataFrame do Pandas.
tvscreener é gratuito? Qual é a licença?
tvscreener é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
tvscreener ainda é mantido?
Manutenção ativa. O último commit de tvscreener foi em 1 de nov. de 2026.
Para que posso usar tvscreener?
Filtrar ações por critérios de valuation, dividendos ou momentum em um notebook Jupyter Monitorar ativos de cripto ou forex em movimento com atualizações periódicas Obter demonstrações financeiras e calendários de resultados para pesquisas Dar acesso a dados de screener para assistentes de IA por meio do servidor MCP
Como instalar tvscreener?
Instale a biblioteca pelo PyPI: pip install tvscreener Importe a biblioteca e execute uma consulta básica do Stock Screener: python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"
Onde consigo tvscreener?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/deepentropy/tvscreener

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados