# Как считают общедоступные API.

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

Обновлено: 2026-10-15
Редакция документации: 2026-10-15.1
Модель портфеля: 2026-10-15.3
Модель калькулятора: 2026-10-15.2

[HTML](https://investboard.com/ru/calculators/api/methodology) · [Документация API](https://investboard.com/ru/calculators/api)

**Зафиксировано:** Справочные данные поставщика, указанные сегменты выручки и исторические цены с доступными датами.

**Рассчитано:** Детерминированные сводки предоставленного портфеля и доступных справочных данных.

**Смоделировано:** Явные допущения для сценариев комиссий, приближенных кризисных сценариев и гипотетических исторических портфелей.

## Исходные данные, единицы и точность

Предоставьте весь портфель, который хотите проанализировать. Для ценных бумаг используются ISIN; для денежных средств указываются assetClass: cash и валюта. Одинаковые ISIN объединяются, как и денежные средства в одной валюте. Общие сопоставления идентификаторов, профили листинга и классификации бумаг проверяются на конфликты идентичности; при конфликте идентичность не угадывается по тикеру или названию.

Для basis: values предоставьте рыночную стоимость, уже пересчитанную в baseCurrency. Анализ снимка не получает цены оценки или валютные курсы для пересчета исходных данных. Для basis: weights используйте положительные доли с суммой один (допуск 0,000001); принятые веса нормализуются по фактической сумме. Для весов денежные результаты снимка и стресс-анализа равны null. Историческое воспроизведение использует явно переданные гипотетические суммы вложений.

Веса портфеля, охват, доходность, комиссии и изменения весов задаются долями: 0,6 означает 60%, 0,002 означает 0,2%, а изменение веса 0,05 означает пять процентных пунктов. Отдельный API финансовых калькуляторов принимает ставки в процентных пунктах, например 6 для 6%; единицы результатов указаны в контракте каждого калькулятора.

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

**Разобранный пример · иллюстративные данные**

Пример: при baseCurrency EUR денежные средства USD со значением 1 000 означают сумму в USD стоимостью 1 000 EUR, а не 1 000 USD.

## Сначала прочитайте знаменатель

Распределение и валюты позиций относятся ко всему предоставленному портфелю. Группы классификации акций, позиции с раскрытием состава фондов, отраслевые и тематические веса и география выручки выражены как доли всего портфеля, относящиеся к распознанной совокупности акций. portfolioShare указывает долю этой совокупности в портфеле; coverage описывает, какая часть указанной совокупности классифицирована или измерена.

Веса эмитентов в концентрации используют совокупность эмитентов акций. Попарное пересечение использует веса компонентов внутри каждого фонда. weightedTer использует только фонды с известным TER. Эти знаменатели различаются, поэтому числа нельзя складывать или подставлять друг вместо друга.

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

Глоссарий: [Распределение активов](https://investboard.com/ru/knowledge/glossary/asset-allocation), [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through), [TER (коэффициент общих расходов)](https://investboard.com/ru/knowledge/glossary/ter)

## Охват, неизвестные данные и непоказанные результаты

Читайте status и reasons даже после HTTP 200. ok означает, что в разделе нет блокирующей причины неполноты; при этом он может сообщать no_equities или fewer_than_two_funds. partial означает полезные, но неполные доказательства. unavailable означает, что запрошенный результат нельзя установить. not_requested отмечает разделы снимка, не включенные в этот вызов.

null означает недоступность или отсутствие измерения, но никогда не ноль. Пустые списки нужно трактовать с учетом причин и охвата. Неизвестные доли и нераспознанные остатки фондов описывают пробелы в доказательствах; tailWeight описывает измеренные строки, пропущенные из-за лимита показа. Не считайте ни то ни другое нулем и не нормализуйте видимый список до 100%.

Охват зависит от показателя: известные классы активов, названные эмитенты, компоненты фондов, отраслевые метки, отчеты о выручке и исторические ряды отвечают на разные вопросы. Сбои поставщика могут оставить частичные результаты. Концентрация не показывается при охвате эмитентов ниже 80%; альтернативам нужны практически полные данные сравнения; историческому воспроизведению нужна пригодность каждой переданной составляющей. Единого порога охвата для всех возможностей нет.

**Разобранный пример · иллюстративные данные**

Пример: совокупность акций 60% с отраслевым охватом 75% дает 45% всего портфеля с отраслевой классификацией. Остальные 15% веса акций неизвестны и не распределяются между известными отраслями.

## Методы анализа портфеля

### Распределение активов (allocation)

Переданные позиции группируются по определенному для них классу активов. Нераспознанные ценные бумаги остаются в неизвестной категории и в общей стоимости портфеля. Это распределение переданного портфеля; сервис не может знать о пропущенных счетах или позициях.

**Расчет**

```text
доля класса = сумма(стоимостей в классе) / сумма(всех переданных стоимостей)
```

**Разобранный пример · иллюстративные данные**

Пример: 6 000 в акциях, 3 000 в облигациях и 1 000 в денежных средствах дают доли 0.6, 0.3 и 0.1. Нераспознанная позиция сохраняется, а не перераспределяется.

Глоссарий: [Распределение активов](https://investboard.com/ru/knowledge/glossary/asset-allocation)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-allocation)

### Пересечения ETF (overlap)

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

Для фондов указываются покрытие компонентов и даты данных. Поле sharedTail сохраняет общую долю, не вошедшую в показанный список общих позиций.

**Расчет**

```text
overlap(A, B) = Σ по общим бумагам min(доля в A, доля в B)
```

**Разобранный пример · иллюстративные данные**

Пример: в A доля X равна 0.4, а Y равна 0.6; в B доля X равна 0.2, а Z равна 0.8. Измеренное пересечение равно 0.2 (20%).

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-overlap)

### Раскрытие состава акций (look-through)

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

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

**Расчет**

```text
доля компании = прямая доля в портфеле + Σ(доля фонда в портфеле × доля компании в фонде)
```

**Разобранный пример · иллюстративные данные**

Пример: фонд составляет 60% портфеля и держит 5% в X. Он дает 3% портфеля в X; прямая позиция в 2% увеличивает общую долю до 5%.

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-look-through)

### Концентрация по компаниям (concentration)

Позиции в ценных бумагах объединяются по определенным эмитентам-компаниям, включая разные классы акций, если это позволяет сопоставление идентичностей. Знаменателем долей эмитентов служит вся акционная часть, включая неотнесенную к эмитентам долю. Если часть этой совокупности нельзя отнести к эмитентам, полученные доли являются нижними границами.

Названия эмитентов, HHI и effectiveN не показываются при покрытии эмитентов ниже 80%. Любая нераспознанная переданная позиция делает раздел недоступным. При покрытии от 80%, если оно неполное, раздел остается частичным; неизвестная доля эмитентов не исключается перенормировкой. Личный лимит концентрации или заключение о соответствии инвестору не предполагаются.

**Расчет**

```text
HHI = Σ долей эмитентов²; effectiveN = 1 / HHI (при HHI > 0)
```

**Разобранный пример · иллюстративные данные**

Пример с полным покрытием: два эмитента с долями по 0.5 дают HHI 0.5 и effectiveN 2. Это эквивалентная мера концентрации, а не число независимых факторов риска.

Глоссарий: [Риск концентрации](https://investboard.com/ru/knowledge/glossary/concentration-risk)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-concentration)

### Диверсификация по секторам (sectors)

Распознанная совокупность базовых акций классифицируется по сектору компании. Доли категорий относятся ко всему переданному портфелю; покрытие описывает классифицированную долю акционной совокупности. Неизвестная классификация остается неизвестной. Это классификация компаний, а не оценка их выручки по секторам и не собственный сектор фонда-оболочки.

**Разобранный пример · иллюстративные данные**

Пример: акционная совокупность составляет 60% портфеля, и половина этой совокупности отнесена к технологиям. Доля технологий в портфеле равна 30%, а не 50%.

Глоссарий: [Распределение активов](https://investboard.com/ru/knowledge/glossary/asset-allocation), [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-sectors)

### Страны и регионы (geography)

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

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-geography)

### Валютная экспозиция (currencies)

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

heldCurrencies отдельно группирует распознанные валюты листинга и указанные клиентом API валюты денежных средств во всем переданном портфеле. Другая валюта листинга сама по себе не меняет базовую экспозицию на компанию. Фонды с указанным в названии хеджированием раскрываются; модель не измеряет эффективность хеджирования.

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-currencies)

### Текущие издержки фондов (costs)

weightedTer взвешивается по фондам с известными текущими издержками, а не по всему портфелю. coveredPortfolioWeight, fundPortfolioWeight и unknownPortfolioWeight показывают это различие. Отсутствующий TER или нулевой TER, сообщенный поставщиком, означает недоступные данные, а не бесплатный фонд.

knownAnnualCost суммирует только измеренные издержки фондов. Если часть издержек неизвестна, это промежуточный итог; для запросов только с долями значение равно null. Брокерские комиссии, спреды покупки и продажи, налоги и разница отслеживания сюда не входят.

**Расчет**

```text
weightedTer = Σ(стоимость фонда с известными издержками × TER) / Σ(стоимость фонда с известными издержками)
knownAnnualCost = Σ(стоимость фонда с известными издержками × TER)
```

**Разобранный пример · иллюстративные данные**

Пример: в портфеле стоимостью 10 000 сумма 6 000 вложена в фонд с TER 0.002, а 4 000 приходится на денежные средства. weightedTer равен 0.002 (0.2%); knownAnnualCost равен 12. Известные издержки относительно всего портфеля составили бы 0.0012: это другой знаменатель.

Глоссарий: [TER (коэффициент общих расходов)](https://investboard.com/ru/knowledge/glossary/ter), [Отклонение доходности от индекса](https://investboard.com/ru/knowledge/glossary/tracking-difference)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-costs)

### Долгосрочное влияние издержек (cost-drag)

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

Сравниваются траектории с комиссией и без нее. totalCostDrag включает комиссии и упущенное накопление сложного процента; averageAnnualCostDrag равен этой общей сумме, деленной на число лет, а не ежегодному счету на оплату. Модель исключает инфляцию, налоги, торговые комиссии и изменение доходности. Рыночные данные не запрашиваются.

**Расчет**

```text
withoutFee[m+1] = withoutFee[m] × (1 + annualReturn/12) + contribution
withFee[m+1] = withFee[m] × (1 + annualReturn/12 − annualFeeRate/12) + contribution
```

**Разобранный пример · иллюстративные данные**

Пример: initialValue 1 000, annualReturn 0.06, annualFeeRate 0.012 и отсутствие взноса дают после первого месяца 1 005 без комиссии и 1 004 с комиссией.

Глоссарий: [TER (коэффициент общих расходов)](https://investboard.com/ru/knowledge/glossary/ter)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-cost-drag)

### Отрасли и темы (industries)

Отраслевые названия поступают из классификаций поставщиков и не гарантируют соответствия отраслевой таксономии GICS. Поддерживаемые определения отраслевых направлений группируют эти названия; версионируемые тематические корзины группируют определенных эмитентов. Для каждой прямой позиции и фонда сначала определяется принадлежность к акционной части, и только затем объединяются идентичности компаний.

Знаменателем долей служит весь портфель. Неизвестная и пропущенная отраслевые доли остаются отдельными. Направления и корзины могут пересекаться, поэтому их доли не обязаны суммироваться до единицы. При неполном покрытии измеренная доля темы является нижней границей; null означает отсутствие измерения, а ноль может означать отсутствие совпадений в измеренной совокупности. При сравнении результатов учитывайте definitionVersion и registryVersion.

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through), [Риск концентрации](https://investboard.com/ru/knowledge/glossary/concentration-risk)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-industries)

### География выручки (revenue-geography)

Исследуются не более 25 крупнейших идентифицируемых базовых компаний акционной части; отбор активов акционной части выполняется до объединения идентичностей. Проверяется листинг компании, выбирается последнее доступное наблюдение с явной отметкой FY, а географические сегменты выручки приводятся к стандартным регионам. Некорректные или отрицательные наборы сегментов отклоняются целиком.

Доли региональной выручки каждой компании взвешиваются по ее доле во всем портфеле. Неисследованные компании и отсутствующие наблюдения остаются неизвестными, а не масштабируются до полного покрытия. Широкие или несопоставленные сегменты остаются в other. reportAsOf является самой ранней датой использованной отчетности; отчетность компаний может относиться к разным финансовым годам. Это измерение заявленной географии продаж, а не домициля, географии прибыли или валюты выручки.

**Расчет**

```text
доля региона = Σ(доля компании в портфеле × заявленная доля выручки в регионе)
```

**Разобранный пример · иллюстративные данные**

Пример: компания составляет 10% портфеля и сообщает, что 40% ее выручки приходится на Европу. Ее вклад в моделируемую экспозицию портфеля на европейскую выручку равен 4%.

Глоссарий: [Анализ базовых активов ETF](https://investboard.com/ru/knowledge/glossary#look-through)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-revenue-geography)

### Сравнение портфелей (compare)

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

Дельта возвращается только тогда, когда оба соответствующих раздела имеют статус ok и оба числа существуют; иначе возвращается null. Положительная дельта означает увеличение показателя, а не обязательно улучшение портфеля. Эти снимки не восстанавливают операции или фактически полученную доходность.

**Расчет**

```text
delta = after − before
```

**Разобранный пример · иллюстративные данные**

Пример: доля сектора меняется с 0.20 до 0.25. Дельта равна 0.05, то есть 5 процентным пунктам, а не относительному росту на 5%.

Глоссарий: [Отклонение распределения активов](https://investboard.com/ru/knowledge/glossary#allokationsdrift)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-compare)

### Планирование взноса (contribution-plan)

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

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

**Расчет**

```text
gap[class] = max(целевая доля − текущая доля, 0)
allocation[class] ≈ contribution × gap[class] / Σ положительных разрывов
```

**Разобранный пример · иллюстративные данные**

Пример: разрывы до целевых долей 0.10 и 0.05 распределяют взнос 300 на 200 и 100 до применения минимальной суммы распределения и округления до центов.

Глоссарий: [Распределение активов](https://investboard.com/ru/knowledge/glossary/asset-allocation), [Ребалансировка](https://investboard.com/ru/knowledge/glossary/rebalancing), [Отклонение распределения активов](https://investboard.com/ru/knowledge/glossary#allokationsdrift)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-contribution-plan)

### Альтернативы ETF (etf-alternatives)

Фонд акций сравнивается максимум с десятью явно заданными ISIN кандидатов либо с ограниченным списком из общего каталога альтернатив. Это не исчерпывающий поиск по рынку. Для расчета баллов нужны известный TER и практически полное покрытие состава, секторов и стран (не менее 0.999999) для обоих фондов.

Сходство объединяет пересечение компонентов с косинусным сходством векторов секторов и стран фонда от поставщика. Эти векторы фонда отличаются от классификаций базовых компаний, используемых в секторных и географических результатах снимка. Совпадение требует score ≥ 0.7 и строго меньшего TER. terSaving равен TER исходного фонда минус TER кандидата, а не оценке денежной экономии инвестора.

Данные по кандидатам и исходному фонду включают даты компонентов; дата расчета каталога не датирует все использованные сведения. Сравнение исключает налоги, спреды, комиссии за переход, разницу отслеживания и соответствие инвестору.

**Расчет**

```text
score = 0.5 × пересечение позиций + 0.25 × косинус секторов + 0.25 × косинус стран
cosine(a,b) = Σ(aᵢbᵢ) / (√Σaᵢ² × √Σbᵢ²)
```

Глоссарий: [TER (коэффициент общих расходов)](https://investboard.com/ru/knowledge/glossary/ter), [Отклонение доходности от индекса](https://investboard.com/ru/knowledge/glossary/tracking-difference)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-etf-alternatives)

### Приближенные стресс-сценарии (stress-scenarios)

Применяются поддерживаемые кризисные предположения для 2008 года, COVID-19, процентного шока 2022 года, кризиса евро или периода доткомов. Для прямых акций используется известный секторный прокси, если он доступен; для фондов применяется прокси класса активов, а не взвешенное восстановление их секторов. Для других поддерживаемых классов используются прокси классов из реестра.

Ценовой шок прокси и шок валюты листинга или денежных средств относительно отчетной валюты однократно объединяются мультипликативно. Поддерживается отчетность в EUR и USD. При отсутствии классификаций, валютных предположений или шоков классов сценарий не показывается. Возвращаются эпизод, источники, методика и дата проверки с approximate: true.

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

**Расчет**

```text
шок позиции = (1 + шок ценового прокси) × (1 + валютный шок) − 1
шок портфеля = Σ(доля в портфеле × шок позиции)
```

**Разобранный пример · иллюстративные данные**

Пример: ценовой шок −20% и валютный шок +10% вместе дают −12%: 0.8 × 1.1 − 1. Сложение шоков дало бы другой результат.

Глоссарий: [Распределение активов](https://investboard.com/ru/knowledge/glossary/asset-allocation)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-stress-scenarios)

### Историческое воспроизведение текущего состава (historical-replay)

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

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

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

CAGR не показывается для расчетов короче одного года. Максимальная просадка является неположительной долей, измеряющей наихудшее падение от пика до минимума на траектории состава; recoveryDate может быть null. Это моделирование текущего состава с эффектом выживших, а не фактическая доходность счета. Оно исключает налоги, торговые издержки и проскальзывание и не является прогнозом.

**Расчет**

```text
цена в базовой валюте[t] = цена в исходной валюте[t] × валютный курс на дату[t]
доходность состава = индекс состава[end] / индекс состава[start] − 1
maxDrawdown = min по t (индекс состава[t] / текущий максимум[t] − 1)
CAGR (elapsed ≥ 365.25 дней) = (индекс состава[end] / индекс состава[start])^(365.25 / elapsed) − 1
```

Глоссарий: [Максимальная просадка](https://investboard.com/ru/knowledge/glossary/maximum-drawdown), [Ребалансировка](https://investboard.com/ru/knowledge/glossary/rebalancing)

[Контракт API и пример](https://investboard.com/ru/calculators/api#portfolio-historical-replay)

## Методы финансовых калькуляторов

Тринадцать конечных точек финансовых калькуляторов используют те же методы, что и интерактивные страницы. Их допущения, источники и ограничения приведены ниже из существующего каталога методологии. Ставки и зависящие от года налоговые правила определяются контрактом каждого калькулятора; выбранная дата asOf не превращает модель в механизм исторических правовых норм.

### Калькулятор налога на доходы от капитала (Германия) (abgeltungssteuer)

Калькулятор моделирует немецкий налог по фиксированной ставке на частные доходы от капитала. Он показывает расчетную налоговую нагрузку и не заменяет налоговую консультацию.

**Налоговая база:** Доход от капитала уменьшается на остаток необлагаемого лимита сберегателя. Налог по фиксированной ставке рассчитывается с облагаемой суммы.

**Надбавки:** Солидарная надбавка рассчитывается с налога по фиксированной ставке. Церковный налог учитывается в зависимости от федеральной земли и выбранной настройки.

**Результат:** Результат показывает сумму налога, эффективную ставку и чистый доход для введенного примера.

**Источники**

- §§ 20 и 32d немецкого Закона о подоходном налоге: доходы от капитала и фиксированная налоговая ставка.
- § 20, абз. 9 немецкого Закона о подоходном налоге: необлагаемый лимит сберегателя.
- Закон о солидарной надбавке и порядок расчета церковного налога по федеральным землям.

**Ограничения**

- Учетные пулы убытков, иностранный налог у источника и особенности учета у брокера могут отличаться.
- Калькулятор моделирует пример, а не полную налоговую декларацию.

[Открыть калькулятор](https://investboard.com/ru/calculators/capital-gains-tax) · [Контракт API и пример](https://investboard.com/ru/calculators/api#abgeltungssteuer)

### Калькулятор дивиденда после налогов (Германия) (netto-dividende)

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

**От суммы до налогов к облагаемой сумме:** Дивиденд до налогов уменьшается на необлагаемый лимит сберегателя и, для фондов, на выбранное частичное освобождение.

**Налоговый профиль:** Налог по фиксированной ставке, солидарная надбавка и необязательный церковный налог рассчитываются по налоговому профилю.

**Дивиденд после налогов:** Калькулятор показывает сумму налога и чистую выплату для введенного дивиденда.

**Источники**

- §§ 20 и 32d немецкого Закона о подоходном налоге: доходы от капитала и налог по фиксированной ставке.
- § 20, абз. 9 немецкого Закона о подоходном налоге: необлагаемый лимит сберегателя.
- § 20 немецкого Закона о налогообложении инвестиций: частичное освобождение фондов.

**Ограничения**

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

[Открыть калькулятор](https://investboard.com/ru/calculators/net-dividend) · [Контракт API и пример](https://investboard.com/ru/calculators/api#netto-dividende)

### Калькулятор Vorabpauschale 2026 (авансовый налог) (vorabpauschale)

Калькулятор моделирует немецкую авансовую расчетную базу Vorabpauschale для инвестиционных фондов и ETF. Он наглядно показывает логику, которую немецкие брокеры обычно применяют автоматически. Результат представляет расчетную налоговую нагрузку и не заменяет налоговую консультацию.

**Базовая доходность:** Стоимость фонда на начало года × базовая процентная ставка × 70 %. Базовая доходность ограничена фактическим приростом стоимости.

**Частичное освобождение:** В зависимости от типа фонда облагаемая сумма уменьшается на применимое частичное освобождение.

**Налоги:** После учета необлагаемого лимита сберегателя рассчитываются налог по фиксированной ставке, солидарная надбавка и, при выборе, церковный налог.

**Источники**

- § 18 немецкого Закона о налогообложении инвестиций: Vorabpauschale.
- § 20 немецкого Закона о налогообложении инвестиций: частичное освобождение по типам фондов.
- Базовая ставка Федерального министерства финансов по налоговым годам и § 20, абз. 9 Закона о подоходном налоге.

**Ограничения**

- Покупки в течение года, округление брокером и иностранные счета могут приводить к отличиям.
- Фактическое списание зависит от брокера и остатка на расчетном счете.
- Общедоступный API v1 моделирует одну позицию, удерживаемую полный год. Несколько позиций и ввод месяца приобретения не поддерживаются. steuerjahr выбирает поддерживаемый налоговый год; asOf не является налоговым годом.

[Открыть калькулятор](https://investboard.com/ru/calculators/vorabpauschale) · [Контракт API и пример](https://investboard.com/ru/calculators/api#vorabpauschale)

Глоссарий: [Vorabpauschale (условно начисленный доход фонда)](https://investboard.com/ru/knowledge/glossary/vorabpauschale)

### Калькулятор накапливающих и распределяющих фондов (thesaurierer-vs-ausschuetter)

Калькулятор сравнивает накапливающие и распределяющие ETF в модели после налогов. Он показывает, как допущения о доходности, выплатах и налогах действуют во времени.

**Две траектории:** Накапливающие и распределяющие ETF рассчитываются с одинаковыми допущениями о доходности, затратах и налогах.

**Налоги:** Модель учитывает выплаты, Vorabpauschale, частичное освобождение и необлагаемый лимит сберегателя.

**Сравнение:** Результат показывает смоделированный итоговый капитал и налоговую нагрузку, а не подходящий конкретному человеку ETF.

**Источники**

- § 18 немецкого Закона о налогообложении инвестиций: Vorabpauschale; § 20: частичное освобождение.
- §§ 20, 20 абз. 9 и 32d немецкого Закона о подоходном налоге: доходы от капитала, необлагаемый лимит и налоговая ставка.
- Допущения пользователя о доходности, доле выплат, затратах и сроке.

**Ограничения**

- Рыночная доходность, страна регистрации фонда, политика выплат и округление брокером могут отличаться.
- Результат является сравнением сценариев, а не рекомендацией типа ETF.

[Открыть калькулятор](https://investboard.com/ru/calculators/accumulating-vs-distributing) · [Контракт API и пример](https://investboard.com/ru/calculators/api#thesaurierer-vs-ausschuetter)

### Оптимизатор Freistellungsauftrag (заявление об освобождении от удержания) (freistellungsauftrag)

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

**Собрать доходы:** Проценты, дивиденды, Vorabpauschale и другие доходы от капитала рассматриваются отдельно по каждому банку или брокеру.

**Распределить лимит:** Доступный необлагаемый лимит сберегателя сопоставляется с ожидаемыми или уже полученными доходами.

**Показать резерв:** Калькулятор показывает, где лимит исчерпан, почти исчерпан или, вероятно, не используется.

**Источники**

- § 20, абз. 9 немецкого Закона о подоходном налоге: необлагаемый лимит сберегателя.
- Немецкие правила заявлений об освобождении доходов от капитала в банках и у брокеров от удержания налога.
- Данные брокера или банка, введенные либо подключенные пользователем.

**Ограничения**

- Калькулятор не подает в банки заявления об освобождении от удержания налога.
- Окончательные взаимозачеты, сторнирования и годовые налоговые справки могут отличаться.

[Открыть калькулятор](https://investboard.com/ru/calculators/freistellungsauftrag) · [Контракт API и пример](https://investboard.com/ru/calculators/api#freistellungsauftrag)

### Калькулятор регулярных вложений в ETF (Германия) (etf-sparplan)

Калькулятор моделирует траекторию плана регулярных вложений в ETF с необязательным налоговым изъятием из-за ежегодной Vorabpauschale. Он показывает расчетную налоговую нагрузку и не заменяет налоговую консультацию.

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

**Налоговое изъятие:** При включенном налоге Vorabpauschale рассчитывается ежегодно (базовая ставка, коэффициент 70%, частичное освобождение по типу фонда, необлагаемый лимит сберегателя) и вычитается из стоимости портфеля.

**Результат:** Результат показывает итоговый капитал с налогом и без него, взносы, прирост и траекторию по годам.

**Источники**

- § 18 немецкого Закона о налогообложении инвестиций: Vorabpauschale; § 20: частичное освобождение.
- § 20, абз. 9 немецкого Закона о подоходном налоге: необлагаемый лимит сберегателя; базовая ставка Федерального министерства финансов по налоговым годам.
- Допущения пользователя о доходности, регулярном взносе, его увеличении и сроке.

**Ограничения**

- Доходность является постоянным допущением; реальная рыночная доходность может отличаться. Затраты фонда и инфляция не моделируются.
- В конце срока налог с продажи не вычитается; итоговый капитал рассчитан до продажи.

[Открыть калькулятор](https://investboard.com/ru/calculators/etf-savings-plan) · [Контракт API и пример](https://investboard.com/ru/calculators/api#etf-sparplan)

### Калькулятор резервного фонда (notgroschen)

Калькулятор переводит Ваши ежемесячные расходы в целевой размер резервного фонда и показывает срок накопления при Вашем регулярном взносе.

**Цель:** Ежемесячные чистые расходы × выбранное число месяцев резерва (3, 6, 9 или 12).

**Траектория накопления:** На существующий резерв ежемесячно начисляется сложный процент, и регулярный взнос добавляется до достижения цели. Для каждого варианта размещения задана иллюстративная ставка (счет до востребования 2,5%, ETF денежного рынка 3,2%, лестница срочных вкладов 3,5% годовых).

**Ориентир:** Калькулятор также предлагает вариант размещения по сроку накопления и показывает целевую дату и долю процентов.

**Источники**

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

**Ограничения**

- Проценты по резерву рассчитываются до налогов; налог по фиксированной ставке на процентный доход не моделируется.
- Номинальное представление без инфляции; фактические ставки по счетам могут отличаться в зависимости от рынка.
- Когда цель не профинансирована, а monthlySavingsCapacity равен нулю, monthsToTarget = 0 и targetDate = asOf не означают достижения цели.

[Открыть калькулятор](https://investboard.com/ru/calculators/emergency-fund) · [Контракт API и пример](https://investboard.com/ru/calculators/api#notgroschen)

### Калькулятор собственных средств на жилье (eigenkapital)

Калькулятор определяет сопутствующие затраты покупки недвижимости и потребность в собственных средствах, а также показывает путь накопления к цели.

**Сопутствующие затраты:** Налог на приобретение недвижимости по федеральной земле плюс фиксированные 2% на нотариуса и земельный реестр и 3,57% комиссии агента от цены покупки.

**Цель по собственным средствам:** Сопутствующие затраты плюс цена покупки × выбранная доля собственных средств (от 10 до 30%).

**Накопление и платеж:** На накопления ежемесячно начисляется выбранная ставка и добавляется регулярный взнос; последующий ежемесячный платеж показан как упрощенный пример процентов.

**Источники**

- Ставки налога на приобретение недвижимости по федеральным землям (от 3,5 до 6,5%).
- GNotKG: затраты на нотариуса и земельный реестр; §§ 656c, 656d BGB: распределение комиссии агента.

**Ограничения**

- Комиссия агента является фиксированным допущением и не применяется к покупке без агента.
- Платеж является примером процентов без графика погашения и без текущей ипотечной ставки; реальные условия могут отличаться.
- Когда цель не профинансирована, а monthlySavingsCapacity равен нулю, monthsToTarget = 0 и targetDate = asOf не означают достижения цели.

[Открыть калькулятор](https://investboard.com/ru/calculators/home-equity) · [Контракт API и пример](https://investboard.com/ru/calculators/api#eigenkapital)

### Калькулятор пенсионного разрыва (rentenluecke)

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

**Оценка пенсии:** Пенсионные баллы = доход до вычетов ÷ средний доход (с ограничением по базе взносов), умноженные на стоимость пенсионного балла (40,79 EUR, по состоянию на июль 2025 года); фиксированный вычет около 11% покрывает медицинское страхование и страхование ухода.

**Разрыв:** Желаемый доход минус оцененная чистая пенсия, помесячно и за год.

**Потребность в капитале:** Годовой разрыв увеличивается с учетом фиксированного налога на снятие 18,5% и капитализируется по ставке снятия 3,5%; существующие накопления и регулярный взнос вычитаются из потребности.

**Источники**

- Исходные данные формулы государственной пенсии: стоимость пенсионного балла (июль 2025 года), средний доход, предельная база взносов.
- Фиксированные допущения модели о вычетах (11%), налоге на снятие (18,5%) и ставке снятия (3,5%).

**Ограничения**

- Предполагается постоянный доход (неизменное число пенсионных баллов за год); индивидуальная трудовая история может отличаться.
- Налогообложение пенсий и снятий представлено фиксированными приближениями; определяющим источником является пенсионная информация Deutsche Rentenversicherung.

[Открыть калькулятор](https://investboard.com/ru/calculators/pension-gap) · [Контракт API и пример](https://investboard.com/ru/calculators/api#rentenluecke)

### Калькулятор плана снятий (entnahmeplan)

Калькулятор моделирует фазу снятия по годам, с налогом по фиксированной ставке на снятия, ежегодной Vorabpauschale и зачетом по § 19 InvStG.

**Стратегии:** Постоянная номинальная сумма, сумма с учетом инфляции или процент текущей стоимости портфеля; снятие задается по стратегии для каждого года.

**Пересчет к сумме до налогов:** Каждое снятие увеличивается так, чтобы после налогов осталась желаемая сумма: зачет обложенных Vorabpauschale, частичное освобождение 30%, остаток необлагаемого лимита сберегателя, затем 26,375%. Предполагается доля прибыли 70% в каждом снятии.

**Траектория:** Предполагаемая доходность и ежегодная Vorabpauschale действуют на остаток капитала до его исчерпания или достижения 50 лет.

**Источники**

- Немецкий Закон о налогообложении инвестиций: § 18 (Vorabpauschale), § 19 (зачет) и § 20 (частичное освобождение).
- § 20, абз. 9 и § 32d немецкого Закона о подоходном налоге: необлагаемый лимит сберегателя и налоговая ставка.
- Допущения пользователя о стоимости портфеля, снятии, доходности, инфляции и стратегии.

**Ограничения**

- Постоянная доходность и отсутствие риска последовательности доходностей; реальные траектории снятия могут отличаться.
- Фиксированная доля прибыли 70% и фиксированное частичное освобождение 30% (фонды акций); индивидуальные портфели могут отличаться.
- Общедоступный адаптер применяет частичное освобождение фондов акций к облагаемой инвестиционной прибыли; он не моделирует произвольное сочетание налоговых режимов.

[Открыть калькулятор](https://investboard.com/ru/calculators/withdrawal-plan) · [Контракт API и пример](https://investboard.com/ru/calculators/api#entnahmeplan)

### Калькулятор налога на дарение (schenkungsteuer)

Калькулятор моделирует немецкий налог на дарение по необлагаемому лимиту, налоговому классу и ступенчатому тарифу, включая десятилетнюю логику.

**Необлагаемый лимит:** Лимит по степени родства (§ 16 ErbStG), умноженный на число дарителей и уменьшенный на подарки за предыдущие десять лет.

**Налоговая ставка:** К облагаемому приобретению применяется ступенчатый тариф § 19 ErbStG с корректировкой по § 19(3) для смягчения налога около границ ступеней.

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

**Источники**

- ErbStG: § 15 (налоговые классы), § 16 (необлагаемые лимиты), § 19 (ставки и корректировка для смягчения налога).
- § 30 ErbStG: обязанность сообщать о дарении.

**Ограничения**

- Модель предполагает финансовые активы; оценка недвижимости или активов предприятия и освобождения по § 13 ErbStG не охвачены, поэтому фактический налог может отличаться.
- Калькулятор не заменяет налоговую консультацию по конкретным передачам.

[Открыть калькулятор](https://investboard.com/ru/calculators/gift-tax) · [Контракт API и пример](https://investboard.com/ru/calculators/api#schenkungsteuer)

### Калькулятор детского брокерского счета (junior-depot)

Калькулятор моделирует полный жизненный цикл детского брокерского счета с ETF акций: накопление, ежегодную Vorabpauschale и налог с продажи в целевом возрасте.

**Траектория накопления:** На единовременную сумму и регулярный взнос (при выборе также детское пособие 259 EUR в месяц) ежемесячно начисляется сложный процент до целевого возраста.

**Ежегодная Vorabpauschale:** Базовая ставка, коэффициент 70%, частичное освобождение 30% и собственный необлагаемый лимит ребенка (1 000 EUR). При наличии справки NV удержание у источника пропускается; зачет по § 19 InvStG продолжается.

**Продажа:** В целевом возрасте прибыль уменьшается на ранее обложенные Vorabpauschale, применяются частичное освобождение и необлагаемый лимит, а остаток облагается по ставке 26,375%.

**Источники**

- §§ 18, 19 и 20 немецкого Закона о налогообложении инвестиций; § 20, абз. 9 и § 44a Закона о подоходном налоге (справка NV).
- Базовая ставка Федерального министерства финансов по налоговым годам; детское пособие 259 EUR в месяц (по состоянию на 2026 год).

**Ограничения**

- Постоянная доходность как допущение; модель ограничена ETF акций.
- Базовый личный необлагаемый минимум и проверка более выгодного налогообложения при продаже намеренно не моделируются; фактический налог может отличаться и часто ниже.
- Общедоступный адаптер использует фонд акций. При включенном useKindergeld текущая смоделированная сумма детского пособия заменяет monthlyContribution; нормализованные исходные данные раскрывают эту сумму.

[Открыть калькулятор](https://investboard.com/ru/calculators/junior-depot) · [Контракт API и пример](https://investboard.com/ru/calculators/api#junior-depot)

### Калькулятор FIRE (fire-rechner)

Калькулятор определяет целевой капитал FIRE с немецкой налоговой надбавкой и моделирует варианты Regular, Coast и Barista.

**Надбавка на налоги:** Для каждого снятия предполагается доля прибыли 70%, применяются частичное освобождение 30% и эффективная ставка (26,375%, выше при церковном налоге); годовые расходы соответственно увеличиваются до суммы до налогов.

**Целевой капитал FIRE:** Годовые расходы до налогов, деленные на выбранную ставку снятия (3,0, 3,5 или 4,0%).

**Варианты и сроки:** Помесячная траектория капитала к цели; Coast дисконтирует целевой капитал FIRE к сегодняшнему дню, Barista уменьшает расходы на доход от частичной занятости.

**Источники**

- § 32d немецкого Закона о подоходном налоге: налоговая ставка; § 20 Закона о налогообложении инвестиций: частичное освобождение.
- Исследование Trinity и анализы Китцеса и Пфау как контекст ставок снятия.
- Допущения пользователя о расходах, доходности, регулярном взносе и ставке снятия.

**Ограничения**

- Постоянная реальная доходность (после предполагаемой инфляции 2%), без риска последовательности доходностей и необлагаемого лимита сберегателя; все показатели в сегодняшней покупательной способности, реальные траектории могут отличаться.
- Доля прибыли 70% является фиксированным допущением; ставку снятия Вы выбираете самостоятельно.

[Открыть калькулятор](https://investboard.com/ru/calculators/fire) · [Контракт API и пример](https://investboard.com/ru/calculators/api#fire-rechner)

## Источники данных и даты наблюдений

Исходные данные портфеля и допущения сценариев предоставляет вызывающая сторона; допущения кризисных потрясений берутся из поддерживаемого реестра сценариев. Общие рыночные справочные сервисы предоставляют сопоставления идентификаторов, профили листинга, сведения и состав фондов, классификации компаний, географические сегменты выручки, историю цен и датированные валютные курсы. Общедоступные адаптеры используют модули классификации и расчета Investboard. Текущие интеграции включают Financial Modeling Prep и общие сервисы идентификаторов и валютных курсов; доступность и охват поставщика ограничивают результаты.

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

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

## Версии и изменения методологии

modelVersion определяет расчетный контракт, возвращаемый API. Редакция документации ниже отдельно определяет это объяснение; изменение формулировок не означает изменения модели. Тематические определения также раскрывают собственные версии реестра и определения. Сохраняйте эти версии и доступные даты наблюдений при сравнении результатов.

2026-10-15 · Первая редакция общедоступной методологии: описывает шестнадцать возможностей портфеля и включает существующие методы, источники и ограничения тринадцати калькуляторов. Эта публикация меняет документацию и ссылки для поиска; поведение расчетов не меняется.