Перейти к основному содержимому

Живые цены для Beancount

Ваши книги. Сегодняшние цены.

Вы записали, чем владеете. Обновляйте стоимость одной строкой обычного текста. Beancount.io берет на себя обновление цен.

Для поддерживаемых источников цен в размещенных книгах Beancount.io.

Выберите источники цен

Какими активами вы владеете?

Загрузка поддерживаемых источников цен…

Есть книга? Найдите ее активы

Ваш фрагмент книги учёта остаётся в вашем браузере.

Добавить в вашу книгу учёта
; Выберите активы выше, чтобы сгенерировать include-строки.

Вставьте в файл, который загружает ваша книга учёта. Символы активов должны соответствовать вашей книге учёта.

Одна строка для подключения
Никаких коммитов при обновлении
Ваши цены имеют приоритет

Ваш следующий отчет не должен начинаться с обновления цен.

Покупка фиксирует момент. Рыночная цена постоянно движется. Если вы отслеживаете инвестиции в обычном тексте, поддержание скриптов котировок и файлов цен может превратиться во вторую работу. Управляемые include цен берут на себя эту рутинную задачу.

Подключитесь один раз. Открывайте книги как обычно.

  1. Добавьте источник цен

    Выберите валюту оценки и активы, которыми владеете, затем вставьте сгенерированные include-строки в файл, который загружает ваша размещённая книга учёта. Символы активов должны соответствовать вашей книге учёта.

  2. Позвольте ценам обновляться

    Когда вы открываете книги, Beancount.io проверяет наличие новых цен после истечения пятиминутного окна обновления.

  3. Читайте свою оценку

    Цены доступны для ваших отчетов. Ваши покупки, продажи, количества и зафиксированные затраты остаются вашими.

Стандартные ценовые записи Beancount
; BTC-USD

2026-09-17 price BTC 92000.00 USD

2026-09-18 price BTC 94000.00 USD
Иллюстративный фрагмент источника. Суммы и время наблюдения — примеры.

Рыночные цены движутся. Ваши записи остаются вашими.

Ваша собственная цена выигрывает

Используйте цену из вашего отчета, когда это необходимо. Цена, записанная вами для той же даты и валютной пары, имеет приоритет независимо от порядка включения файлов.

Сохраняйте чистую историю

Обновление цены не перезаписывает вашу книгу и не создает Git-коммит. Ваша история сосредоточена на изменениях, которые вы вносите.

Неудачное обновление сохраняет последнюю хорошую цену

Когда источник недоступен, можно использовать ранее проверенную кэшированную цену. Она может быть устаревшей; кэшированная цена — это не новое рыночное наблюдение.

История цен оставляет место для ваших книг

Управляемые ценовые записи не учитываются в лимите записей вашей книги.

Начните с источника, который можно проверить.

Каждый поддерживаемый источник — это читаемый текст Beancount с датами цен и метаданными источника. Выберите валюту оценки выше, чтобы увидеть перечисленные источники цен для ваших активов.

Изучите отслеживание инвестиций

Пример источника цен

Биткоин / доллар СШАBTC-USD

Каталог включает криптовалюты, акции, фонды и иностранные валюты. Покрытие зависит от пары; селектор показывает источники, перечисленные для выбранной валюты.

Выберите источники цен

URL-include — это расширение Beancount.io. Оригинальный Beancount и Fava требуют локальных файлов цен.

Несколько вещей, о которых стоит знать.

Читать руководство по bea CLI
Это цены реального времени для торговли?

Это автоматически обновляемые цены для оценки. Размещенный загрузчик проверяет наличие новых данных, когда загружается ваша книга, после пятиминутного окна обновления. Время наблюдения у провайдера может быть более ранним. Это не потоковый торговый канал.

Изменит ли обновление мою себестоимость или транзакции?

Нет. Управляемый источник предоставляет только ценовые директивы. Цены влияют на рыночную оценку; они не меняют количества, затраты на покупку, денежные потоки, комиссии или реализованную прибыль, записанные в вашей книге.

Могу ли я использовать свои цены?

Да. Ваша собственная цена имеет приоритет для той же даты и валютной пары, включая обратную пару, независимо от порядка include. Управляемая цена на более позднюю дату все еще может быть использована.

Что произойдет, если источник цен станет недоступен?

Неудачное обновление не заменяет проверенный кэшированный источник пустым. Кэшированные цены могут быть устаревшими. Если проверенная цена недоступна, ваши книги все равно загрузятся, но этот актив может остаться без рыночной оценки.

Работает ли URL-include в оригинальном Beancount или Fava?

Оригинальный Beancount и Fava сами не загружают URL-include. Используйте эту настройку в размещенных книгах Beancount.io. Совместимые версии bea CLI также разрешают управляемые include и могут экспортировать локальные файлы цен для офлайн-инструментов; см. руководство по CLI.

Какие активы я могу подключить?

Выберите валюту оценки, затем выберите быстрый доступ или выполните поиск по коду актива. Селектор использует текущий каталог цен и генерирует include-строки для перечисленных пар. Пара, отсутствующая в каталоге, может по-прежнему поддерживаться через производные по запросу; она не включается в скопированную конфигурацию, пока поддержка не подтверждена. Используйте соответствующие символы активов в вашей книге учёта.

Храните свои книги. Забудьте о рутине обновления цен.

Добавьте поддерживаемый ценовой include в свою размещенную книгу, и пусть ваша следующая оценка начнется с более свежих данных.