Repolode
Folgerjun

Folgerjun/stock-tui

Ferramenta de terminal que exibe informações básicas de ações A e um gráfico de candles em ASCII com volume, usando dados da AKShare.

Alternativa open source a:Wind TerminalTonghuashun

Estrelas
153
Forks
14
Issues abertas
1
Último commit
há 2 meses

O que é?

stock-tui é uma ferramenta de linha de comando para consultar ações A chinesas em um terminal, como PowerShell, Windows Terminal ou um shell Linux. Ao informar o código da ação ou o nome da empresa em chinês, ela exibe um painel com o preço mais recente, a variação percentual, a abertura, o fechamento anterior, a máxima e a mínima, P/L (dinâmico), P/VP, volume, valor negociado, giro e valor de mercado total e em circulação.

Além da tabela de resumo, a ferramenta desenha um gráfico de candles em ASCII com um gráfico de barras de volume abaixo, usando vermelho para altas e verde para quedas. O número de pregões exibidos e o modo de ajuste de preço (ajustado para frente, ajustado para trás ou sem ajuste) são definidos por opções de linha de comando. É possível desativar o gráfico para obter uma visualização rápida somente em texto.

Os dados de mercado vêm da AKShare, que não exige chave de API e utiliza endpoints públicos de cotações da Eastmoney e da Xueqiu. A ferramenta armazena localmente em cache a lista completa de códigos e nomes do mercado por um dia para agilizar buscas por nome, ignora proxies locais e tenta novamente em caso de erros de rede.

Recursos principais

  • 01Exibe o preço mais recente, a variação, P/L, P/VP, volume, valor negociado e valor de mercado de ações A.
  • 02Desenha um gráfico de candles no terminal com histograma de volume em vermelho e verde.
  • 03Aceita códigos de ações com ou sem o prefixo da bolsa, ou nomes de ações em chinês.
  • 04Permite escolher o número de pregões e o ajuste de preço para frente, para trás ou sem ajuste.
  • 05Pode ser instalado como ferramenta de linha de comando com pip.

Casos de uso

  • Consultar o preço e a avaliação de uma ação chinesa pelo terminal, sem abrir o navegador.
  • Visualizar rapidamente um gráfico de candles dos últimos meses em uma sessão SSH ou de console.
  • Buscar cotações de ações A pelo nome da empresa em scripts ou fluxos de trabalho diários.

Início rápido

  1. 1

    Acessar a pasta do projeto

    cd stock-tui
  2. 2

    Criar um ambiente virtual

    python -m venv .venv
  3. 3

    Instalar as dependências

    .\.venv\Scripts\pip install -r requirements.txt
  4. 4

    Exibir as informações de uma ação e seu gráfico K-line (600519 é a Kweichow Moutai)

    .\.venv\Scripts\python.exe main.py 600519

Antes de usar

  • O projeto não tem licença, então os termos de uso não estão claros.
  • Abrange apenas ações A da China e depende das interfaces públicas de cotações da East Money e do Xueqiu via AKShare.

Tópicos

Perguntas frequentes

O que é stock-tui?
Ferramenta de terminal que exibe informações básicas de ações A e um gráfico de candles em ASCII com volume, usando dados da AKShare. stock-tui é uma ferramenta de linha de comando para consultar ações A chinesas em um terminal, como PowerShell, Windows Terminal ou um shell Linux. Ao informar o código da ação ou o nome da empresa em chinês, ela exibe um painel com o preço mais recente, a variação percentual, a abertura, o fechamento anterior, a máxima e a mínima, P/L (dinâmico), P/VP, volume, valor negociado, giro e valor de mercado total e em circulação.
stock-tui é gratuito? Qual é a licença?
stock-tui não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
stock-tui ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de stock-tui foi em 26 de ago. de 2026.
Para que posso usar stock-tui?
Consultar o preço e a avaliação de uma ação chinesa pelo terminal, sem abrir o navegador. Visualizar rapidamente um gráfico de candles dos últimos meses em uma sessão SSH ou de console. Buscar cotações de ações A pelo nome da empresa em scripts ou fluxos de trabalho diários.
Como instalar stock-tui?
Acessar a pasta do projeto: cd stock-tui Criar um ambiente virtual: python -m venv .venv Instalar as dependências: .\.venv\Scripts\pip install -r requirements.txt Exibir as informações de uma ação e seu gráfico K-line (600519 é a Kweichow Moutai): .\.venv\Scripts\python.exe main.py 600519
Onde consigo stock-tui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Folgerjun/stock-tui

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

Projetos relacionados