Calculadora de capital flutuante

Se as ações restritas superam o total de ações em circulação, a tarefa falha com invalid_input em vez de inventar um flutuante negativo.

O que é o capital flutuante e como se subtraem restritas e posições internas

A identidade é free_float igual a shares_outstanding menos restricted_shares menos insider_holdings. O endpoint não busca relatórios, tabelas de titularidade beneficiária nem cotações ao vivo; aplica as três contagens que você já extraiu para que gabaritos, widgets de landing e automação compartilhem uma única cifra pública de ações auditável.

Contrato de entrada, formato da resposta e comportamento de erro

Se restritas mais internas superam as em circulação, a tarefa também falha porque o flutuante não pode ser negativo. Validação que falha não consome saldo, o que mantém baratos os scripts exploratórios quando quem desenvolve envia de propósito um bloco restrito maior que as em circulação para confirmar o caminho de erro. Envie por POST um corpo JSON com três números finitos obrigatórios. shares_outstanding (aliases total_shares, outstanding_shares, shares, number_of_shares e shares_issued) é a contagem inicial e o denominador do percentual; deve ser um número finito estritamente maior que zero. restricted_shares (aliases restricted, restricted_stock e lockup_shares) é o bloco não negociável e deve ser finito e maior ou igual a zero. insider_holdings (aliases insider_shares, insiders e insider_ownership) é o bloco de afiliados subtraído depois das restritas e deve ser finito e maior ou igual a zero. Em caso de sucesso o corpo ecoa shares_outstanding, restricted_shares e insider_holdings, depois free_float como a contagem pública, free_float_percent como porcento das em circulação e uma string formula que reescreve que o flutuante é as em circulação menos restritas menos internas. Exemplo: um bilhão de ações em circulação, cento e cinquenta milhões restritas e cem milhões de posições internas devolvem free_float setecentos e cinquenta milhões e free_float_percent setenta e cinco. Campos ausentes, valores não finitos, uma contagem restrita ou interna negativa, ou uma contagem em circulação zero ou negativa falham com invalid_input nomeando o campo e não são cobrados. Restritas que superam o total em circulação falham com uma mensagem invalid_input dedicada em vez de um flutuante negativo. Prefira números JSON simples a strings com vírgulas, rótulos de classe de ação ou sinais de porcento; strings numéricas só são aceitas quando batem com um padrão estrito de número finito. O preço é um US$ 0,002 fixo por chamada bem-sucedida com unit item.

Onde uma calculadora de capital flutuante agrega valor

Filtros de índice e de liquidez usam o flutuante em vez de ações totalmente diluídas para que um papel de controle fechado não seja tratado como se toda a capitalização pudesse negociar em um dia. Educadores e plataformas LMS precisam de um oráculo para a pergunta de definição que pede calcular o flutuante a partir das em circulação, das restritas e das internas, inclusive o caso em que as restritas superam as em circulação e devem ser rejeitadas. Use esta capacidade quando você já tem as três contagens de ações; se tem capitalização de mercado, dívida e caixa, use uma calculadora de valor da empresa em vez desta identidade de flutuante. Cadernos de pesquisa de renda variável e arquivos de cap table costumam guardar ações em circulação, ações de lock-up e titularidade de insiders em colunas separadas; um endpoint determinístico recupera o flutuante sem uma célula de planilha que alguém depois reescreveria como capitalização de mercado ao multiplicar as em circulação pelo preço. Integradores ligam o endpoint a notebooks, ferramentas de fluxo ou edge workers para fixar goldens quando um relatório atualiza o calendário de lock-up ou um Form 4 muda o total de insiders. Mantenha shares_outstanding estritamente positivo, restricted_shares e insider_holdings não negativos e dentro das em circulação, fixe os campos free_float e free_float_percent arredondados nos testes e obtenha contagens públicas reproduzíveis para widgets, salas de aula e produção sem montar seu próprio terminal de dados de renda variável.