twelvedata-python

twelvedata-python é o cliente Python oficial para a API financeira e o serviço WebSocket da Twelve Data. Ele requer uma chave de API da Twelve Data; o README informa que o acesso ao WebSocket está disponível nos planos Pro e superiores. A biblioteca recupera séries temporais OHLC para ações, forex, criptomoedas, ETFs e índices. Ela também fornece cotações, preços em tempo real e de fim de dia, taxas de câmbio e conversão de moedas. Os métodos de fundamentos cobrem perfis e logotipos de empresas, dividendos, desdobramentos, lucros e calendários, calendários de IPO, estatísticas, transações de insiders, demonstrações de resultados, balanços patrimoniais, fluxo de caixa, executivos e detentores institucionais ou de fundos. As requisições de séries temporais suportam parâmetros como símbolo, intervalo, bolsa, código MIC, país, tamanho da saída, fuso horário, datas de início e fim e ordem de classificação. Os resultados podem ser retornados como JSON, CSV, DataFrames do pandas ou URLs de requisição. Mais de 100 indicadores técnicos podem ser encadeados em uma requisição de série temporal, e os dados OHLC podem ser excluídos quando apenas os indicadores forem necessários. Requisições em lote aceitam uma string separada por vírgulas ou uma lista de símbolos, com até 120 símbolos por chamada à API. A saída em lote suporta formatos JSON e pandas, incluindo um DataFrame MultiIndex para símbolo e data e hora. Dependências opcionais adicionam recursos de gráficos e streaming. Gráficos estáticos usam matplotlib e mplfinance, enquanto gráficos interativos usam Plotly. O cliente WebSocket fornece streams orientados a eventos para ações, forex e cripto, com métodos para assinar, cancelar assinatura, redefinir assinaturas, conectar, desconectar e enviar heartbeats. A funcionalidade avançada inclui requisições para endpoints personalizados da Twelve Data, inspeção do uso atual de créditos da API e geração das URLs subjacentes para depuração. O pacote é instalado com pip e distribuído sob a licença MIT.