Configure preços automáticos no Beancount

Use o Live Prices para adicionar preços de avaliação atualizados automaticamente a um livro Beancount.io hospedado. Os feeds gerenciados fornecem diretivas price datadas para criptomoedas, ações, fundos e moedas estrangeiras suportados. Você continua registrando compras, vendas e transferências normalmente.

Escolha suas fontes de preços​

1. Abra o seletor de fontes de preços.
2. Escolha a moeda na qual você deseja avaliar seus ativos.
3. Selecione seus ativos nos atalhos ou pesquise por símbolo, como BTC ou AAPL. Você também pode colar um trecho do livro para encontrar seus ativos; o trecho permanece no seu navegador.
4. Verifique se cada símbolo de ativo corresponde à commodity no seu livro. O seletor gera includes para os pares listados. Um par não listado pode suportar derivação sob demanda, mas o seletor o deixa de fora até que o suporte seja confirmado.
5. Copie os includes gerados. Faça login no Beancount.io para usar seu livro hospedado e inspecionar feeds que exigem autenticação.

Escolha a moeda de avaliação para seus registros, não para o idioma desta página. Selecionar uma moeda de cotação não renomeia commodities nem altera suas transações.

Inclua os feeds no seu livro hospedado​

Cole as linhas geradas em main.bean, ou em outro arquivo que seu livro já inclua. Cada linha identifica uma fonte de preços. Por exemplo, o include hospedado para Bitcoin em dólares americanos é mostrado comentado abaixo para que este exemplo permaneça seguro de carregar com o Beancount upstream:

; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"

Remova o ; inicial ao adicionar a linha ao seu livro hospedado. Includes de URL são uma extensão do Beancount.io. Includes locais comuns ainda usam nomes de arquivos, conforme descrito em suporte a múltiplos arquivos.

Abra seu livro normalmente. Seu carregador resolve feeds gerenciados em entradas de preço somente leitura. Ele verifica novos dados quando o livro é carregado após a janela de atualização de cinco minutos. Atualizar preços não reescreve seus arquivos de origem nem cria commits no livro. Entradas de preço gerenciadas não contam para o limite de entradas do seu livro.

Leia preços e avaliações​

Um feed contém preços datados e pode incluir metadados price-source, price-kind, observed-at e provisional. Inspecione o horário de observação e o tipo de preço ao avaliar uma cotação. O horário de atualização do carregador não é o horário de observação do provedor.

Estes são preços de avaliação atualizados automaticamente, não cotações de negociação em tempo real. Um relatório precisa de um preço para o par de commodities relevante na data de avaliação ou antes dela. O preço de hoje não pode preencher uma lacuna em um relatório anterior.

Os preços possibilitam a avaliação de mercado em ferramentas e relatórios que usam diretivas de preço. Uma visualização de conta mostrando custo ainda mostrará custo; conectar um feed não muda essa visualização para valor de mercado. Consulte o guia de consultas para a distinção entre custo e avaliação de mercado.

Uma atualização de preços não altera quantidades, custos de compra, fluxos de caixa, taxas ou ganhos realizados registrados no seu livro. Também não preenche o preço @ ou {cost} de uma transação. Registre esses a partir da própria transação. Avaliações de imóveis, commodities fictícias de exemplo e ativos sem um feed suportado ainda precisam dos seus próprios preços datados.

Substitua um preço gerenciado​

Escreva sua própria diretiva price datada em um arquivo de livro editável quando precisar de uma avaliação específica. Para a mesma data e par de commodities, seu preço tem precedência sobre o feed gerenciado. Isso também se aplica ao par recíproco e não depende da ordem dos includes.

Um preço manual não é um bloqueio permanente: uma cotação gerenciada em uma data posterior ainda pode ser usada para uma avaliação posterior. As entradas gerenciadas em si são somente leitura. Edite sua própria diretiva de preço, ou remova o include para parar de usar aquele feed.

Use preços com ferramentas locais​

Para comportamento da CLI específico de versão, use o guia de preços gerenciados do bea. Versões compatíveis oferecem bea price status, bea price refresh e bea price export --output audit. Use bea --offline balance para leituras apenas de cache ou bea --strict-prices check para rejeitar fontes desatualizadas ou indisponíveis. Consulte a referência da CLI para detalhes e o fluxo de trabalho alternativo do Beanprice local.

A CLI busca sem credenciais e recusa redirecionamentos. Um feed que redireciona para o login hospedado não está disponível para uma nova busca da CLI, mesmo que você esteja conectado pelo navegador. Use um feed suportado acessível ou preços datados locais. Versões mais antigas da CLI podem tratar qualquer include de URL como um glob de arquivo sem correspondência.

Mantenha arquivos de preços datados locais quando precisar de um relatório offline reproduzível. Um commit do livro sozinho não captura a revisão do feed gerenciado usada por uma avaliação passada. Preserve os preços usados junto com o livro e o relatório.

Para integrações com o serviço de preços, consulte a referência da API de Preços. Seus endpoints são separados de adicionar um include a um livro hospedado.

Solucione uma avaliação ausente ou inesperada​

Consulte a referência de sintaxe de preços para diretivas manuais e os exemplos de livros funcionais para registros de investimento estáticos e reproduzíveis.