# Як рахують загальнодоступні API.

Розберіться в розрахунку, перш ніж тлумачити результат. Ці методи пояснюють, що вимірюється, яку сукупність описує показник і де закінчуються доступні докази.

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

[HTML](https://investboard.com/uk/calculators/api/methodology) · [Документація API](https://investboard.com/uk/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%; одиниці результатів указано в контракті кожного калькулятора.

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

**Розібраний приклад · ілюстративні дані**

Приклад: за baseCurrency EUR грошові кошти USD зі значенням 1 000 означають суму в USD вартістю 1 000 EUR, а не 1 000 USD.

## Спочатку прочитайте знаменник

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

Ваги емітентів у концентрації використовують сукупність емітентів акцій. Попарний перетин використовує ваги компонентів усередині кожного фонду. weightedTer використовує лише фонди з відомим TER. Ці знаменники відрізняються, тому числа не можна додавати або підставляти одне замість одного.

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

Глосарій: [Розподіл активів](https://investboard.com/uk/knowledge/glossary/asset-allocation), [Аналіз базових активів ETF](https://investboard.com/uk/knowledge/glossary#look-through), [TER (коефіцієнт загальних витрат)](https://investboard.com/uk/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/uk/knowledge/glossary/asset-allocation)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary#look-through)

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-overlap)

### Розкриття складу акцій (look-through)

Частка кожного фонду в портфелі множиться на частки його компонентів, після чого однакові ідентичності паперів об’єднуються з безпосередніми позиціями. Відомості про походження відокремлюють безпосереднє володіння від вкладень через кожен фонд. Подання акційної частини описує компанії; фонди облігацій, грошових коштів, золота й криптовалют зберігаються цілком і не розкриваються до компонентів-акцій.

Нерозкрита частка фондів акцій показана в unresolvedFundWeight. Іменовані позиції поза запитаним лімітом залишаються в tailWeight. Жодна із цих часток не перерозподіляється без зазначення між видимими компаніями.

**Розрахунок**

```text
частка компанії = безпосередня частка в портфелі + Σ(частка фонду в портфелі × частка компанії у фонді)
```

**Розібраний приклад · ілюстративні дані**

Приклад: фонд становить 60% портфеля й тримає 5% у X. Він дає 3% портфеля в X; безпосередня позиція у 2% збільшує загальну частку до 5%.

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

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/concentration-risk)

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-concentration)

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

Розпізнана сукупність базових акцій класифікується за сектором компанії. Частки категорій стосуються всього переданого портфеля; покриття описує класифіковану частку акційної сукупності. Невідома класифікація залишається невідомою. Це класифікація компаній, а не оцінка їхньої виручки за секторами й не власний сектор фонду-оболонки.

**Розібраний приклад · ілюстративні дані**

Приклад: акційна сукупність становить 60% портфеля, і половина цієї сукупності віднесена до технологій. Частка технологій у портфелі дорівнює 30%, а не 50%.

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

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-sectors)

### Країни та регіони (geography)

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

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

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-geography)

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

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

heldCurrencies окремо групує розпізнані валюти лістингу й указані клієнтом API валюти грошових коштів у всьому переданому портфелі. Інша валюта лістингу сама собою не змінює базової експозиції на компанію. Фонди із зазначеним у назві хеджуванням розкриваються; модель не вимірює ефективності хеджування.

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

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/ter), [Відхилення дохідності від індексу](https://investboard.com/uk/knowledge/glossary/tracking-difference)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/ter)

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-cost-drag)

### Галузі й теми (industries)

Галузеві назви надходять із класифікацій постачальників і не гарантують відповідності галузевій таксономії GICS. Підтримувані визначення галузевих напрямів групують ці назви; тематичні кошики з версіями групують визначених емітентів. Для кожної безпосередньої позиції й фонду спочатку визначається належність до акційної частини, і лише потім об’єднуються ідентичності компаній.

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

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

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-industries)

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

Досліджуються не більш як 25 найбільших ідентифікованих базових компаній акційної частини; відбір активів акційної частини виконується до об’єднання ідентичностей. Перевіряється лістинг компанії, вибирається останнє доступне спостереження з явною позначкою FY, а географічні сегменти виручки приводяться до стандартних регіонів. Некоректні або від’ємні набори сегментів відхиляються цілком.

Частки регіональної виручки кожної компанії зважуються за її часткою в усьому портфелі. Недосліджені компанії та відсутні спостереження залишаються невідомими, а не масштабуються до повного покриття. Широкі або незіставлені сегменти залишаються в other. reportAsOf є найранішою датою використаної звітності; звітність компаній може стосуватися різних фінансових років. Це вимірювання заявленої географії продажів, а не доміцилю, географії прибутку чи валюти виручки.

**Розрахунок**

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

**Розібраний приклад · ілюстративні дані**

Приклад: компанія становить 10% портфеля й повідомляє, що 40% її виручки припадає на Європу. Її внесок у модельовану експозицію портфеля на європейську виручку дорівнює 4%.

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

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-revenue-geography)

### Порівняння портфелів (compare)

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

Дельта повертається лише тоді, коли обидва відповідні розділи мають статус ok та обидва числа існують; інакше повертається null. Додатна дельта означає збільшення показника, а не обов’язково поліпшення портфеля. Ці знімки не відновлюють операції або фактично отриману дохідність.

**Розрахунок**

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

**Розібраний приклад · ілюстративні дані**

Приклад: частка сектора змінюється з 0.20 до 0.25. Дельта дорівнює 0.05, тобто 5 відсотковим пунктам, а не відносному зростанню на 5%.

Глосарій: [Відхилення розподілу активів](https://investboard.com/uk/knowledge/glossary#allokationsdrift)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/asset-allocation), [Ребалансування](https://investboard.com/uk/knowledge/glossary/rebalancing), [Відхилення розподілу активів](https://investboard.com/uk/knowledge/glossary#allokationsdrift)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/ter), [Відхилення дохідності від індексу](https://investboard.com/uk/knowledge/glossary/tracking-difference)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/asset-allocation)

[Контракт API й приклад](https://investboard.com/uk/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/uk/knowledge/glossary/maximum-drawdown), [Ребалансування](https://investboard.com/uk/knowledge/glossary/rebalancing)

[Контракт API й приклад](https://investboard.com/uk/calculators/api#portfolio-historical-replay)

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

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

### Калькулятор податку на доходи від капіталу (Німеччина) (abgeltungssteuer)

Калькулятор моделює німецький податок за фіксованою ставкою на приватні доходи від капіталу. Він показує розрахункове податкове навантаження й не замінює податкової консультації.

**Податкова база:** Дохід від капіталу зменшується на залишок неоподатковуваного ліміту заощадника. Податок за фіксованою ставкою розраховується з оподатковуваної суми.

**Надбавки:** Солідарна надбавка розраховується з податку за фіксованою ставкою. Церковний податок враховується залежно від федеральної землі й вибраного налаштування.

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

**Джерела**

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

**Обмеження**

- Облікові пули збитків, іноземний податок у джерела та особливості обліку в брокера можуть відрізнятися.
- Калькулятор моделює приклад, а не повну податкову декларацію.

[Відкрити калькулятор](https://investboard.com/uk/calculators/capital-gains-tax) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#abgeltungssteuer)

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

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

**Від суми до податків до оподатковуваної суми:** Дивіденд до податків зменшується на неоподатковуваний ліміт заощадника й, для фондів, на вибране часткове звільнення.

**Податковий профіль:** Податок за фіксованою ставкою, солідарна надбавка й необов’язковий церковний податок розраховуються за податковим профілем.

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

**Джерела**

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

**Обмеження**

- Іноземний податок у джерела, угоди про уникнення подвійного оподаткування та взаємозалік у брокера спрощено.
- Розрахунок є наближенням для приватних платників податків Німеччини.

[Відкрити калькулятор](https://investboard.com/uk/calculators/net-dividend) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#netto-dividende)

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

Калькулятор моделює німецьку авансову розрахункову базу Vorabpauschale для інвестиційних фондів та ETF. Він наочно показує логіку, яку німецькі брокери зазвичай застосовують автоматично. Результат є розрахунковим податковим навантаженням і не замінює податкової консультації.

**Базова дохідність:** Вартість фонду на початок року × базова процентна ставка × 70 %. Базова дохідність обмежена фактичним приростом вартості.

**Часткове звільнення:** Залежно від типу фонду оподатковувана сума зменшується на застосовне часткове звільнення.

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

**Джерела**

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

**Обмеження**

- Купівлі протягом року, округлення брокером та іноземні рахунки можуть призводити до відмінностей.
- Фактичне списання залежить від брокера й залишку на розрахунковому рахунку.
- Загальнодоступний API v1 моделює одну позицію, утримувану повний рік. Кілька позицій і введення місяця придбання не підтримуються. steuerjahr вибирає підтримуваний податковий рік; asOf не є податковим роком.

[Відкрити калькулятор](https://investboard.com/uk/calculators/vorabpauschale) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#vorabpauschale)

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

### Калькулятор накопичувальних і розподільчих фондів (thesaurierer-vs-ausschuetter)

Калькулятор порівнює накопичувальні та розподільчі ETF у моделі після податків. Він показує, як припущення про дохідність, виплати й податки діють у часі.

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

**Податки:** Модель враховує виплати, Vorabpauschale, часткове звільнення та неоподатковуваний ліміт заощадника.

**Порівняння:** Результат показує змодельований підсумковий капітал і податкове навантаження, а не ETF, що підходить конкретній людині.

**Джерела**

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

**Обмеження**

- Ринкова дохідність, країна реєстрації фонду, політика виплат і округлення брокером можуть відрізнятися.
- Результат є порівнянням сценаріїв, а не рекомендацією типу ETF.

[Відкрити калькулятор](https://investboard.com/uk/calculators/accumulating-vs-distributing) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#thesaurierer-vs-ausschuetter)

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

Калькулятор розподіляє німецький неоподатковуваний ліміт заощадника між банками й брокерами. Мета полягає в тому, щоб показати, де ліміт використовується або залишається невикористаним. Розподіл є розрахунковим і не замінює податкової консультації.

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

**Розподілити ліміт:** Доступний неоподатковуваний ліміт заощадника зіставляється з очікуваними або вже отриманими доходами.

**Показати резерв:** Калькулятор показує, де ліміт вичерпаний, майже вичерпаний або, ймовірно, не використовується.

**Джерела**

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

**Обмеження**

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

[Відкрити калькулятор](https://investboard.com/uk/calculators/freistellungsauftrag) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#freistellungsauftrag)

### Калькулятор регулярних вкладень в ETF (Німеччина) (etf-sparplan)

Калькулятор моделює траєкторію плану регулярних вкладень в ETF із необов’язковим податковим вилученням через щорічну Vorabpauschale. Він показує розрахункове податкове навантаження й не замінює податкової консультації.

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

**Податкове вилучення:** За ввімкненого податку Vorabpauschale розраховується щороку (базова ставка, коефіцієнт 70%, часткове звільнення за типом фонду, неоподатковуваний ліміт заощадника) і віднімається від вартості портфеля.

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

**Джерела**

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

**Обмеження**

- Дохідність є сталим припущенням; реальна ринкова дохідність може відрізнятися. Витрати фонду й інфляція не моделюються.
- Наприкінці строку податок із продажу не віднімається; підсумковий капітал розраховано до продажу.

[Відкрити калькулятор](https://investboard.com/uk/calculators/etf-savings-plan) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#etf-sparplan)

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

Калькулятор перетворює Ваші щомісячні витрати на цільовий розмір резервного фонду й показує строк накопичення за Вашого регулярного внеску.

**Ціль:** Щомісячні чисті витрати × вибрана кількість місяців резерву (3, 6, 9 або 12).

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

**Орієнтир:** Калькулятор також пропонує варіант розміщення за строком накопичення й показує цільову дату та частку процентів.

**Джерела**

- Практичне правило резерву на три-шість місяців витрат із рекомендацій для споживачів.
- Ілюстративні процентні ставки є припущеннями моделі, а не поточними ринковими умовами.

**Обмеження**

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

[Відкрити калькулятор](https://investboard.com/uk/calculators/emergency-fund) · [Контракт API й приклад](https://investboard.com/uk/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/uk/calculators/home-equity) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#eigenkapital)

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

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

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

**Розрив:** Бажаний дохід мінус оцінена чиста пенсія, помісячно й за рік.

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

**Джерела**

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

**Обмеження**

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

[Відкрити калькулятор](https://investboard.com/uk/calculators/pension-gap) · [Контракт API й приклад](https://investboard.com/uk/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/uk/calculators/withdrawal-plan) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#entnahmeplan)

### Калькулятор податку на дарування (schenkungsteuer)

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

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

**Податкова ставка:** До оподатковуваного придбання застосовується ступінчастий тариф § 19 ErbStG із коригуванням за § 19(3) для пом’якшення податку біля меж ступенів.

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

**Джерела**

- ErbStG: § 15 (податкові класи), § 16 (неоподатковувані ліміти), § 19 (ставки й коригування для пом’якшення податку).
- § 30 ErbStG: обов’язок повідомляти про дарування.

**Обмеження**

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

[Відкрити калькулятор](https://investboard.com/uk/calculators/gift-tax) · [Контракт API й приклад](https://investboard.com/uk/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/uk/calculators/junior-depot) · [Контракт API й приклад](https://investboard.com/uk/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/uk/calculators/fire) · [Контракт API й приклад](https://investboard.com/uk/calculators/api#fire-rechner)

## Джерела даних і дати спостережень

Вихідні дані портфеля й припущення сценаріїв надає сторона, що викликає API; припущення кризових потрясінь беруться з підтримуваного реєстру сценаріїв. Спільні ринкові довідкові сервіси надають зіставлення ідентифікаторів, профілі лістингу, відомості й склад фондів, класифікації компаній, географічні сегменти виторгу, історію цін і датовані валютні курси. Загальнодоступні адаптери використовують модулі класифікації й розрахунку Investboard. Поточні інтеграції включають Financial Modeling Prep і спільні сервіси ідентифікаторів та валютних курсів; доступність і охоплення постачальника обмежують результати.

computedAt означає час запиту. constituentsAsOf фіксує найстарішу відому дату складу у відповідному результаті; вона не датує кожну класифікацію. reportAsOf датує найстаріше використане річне спостереження виторгу. Порівняння альтернатив окремо розкривають дати фондів і розрахунків каталогу. Джерела стрес-сценаріїв, дати епізодів і reviewedAt описують підтримуване наближення. Історичне відтворення розкриває запитані й фактичні вікна, валюти котирувань і базу ціни або повної дохідності для кожної складової.

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

## Версії та зміни методології

modelVersion визначає розрахунковий контракт, що повертається API. Редакція документації нижче окремо визначає це пояснення; зміна формулювань не означає зміни моделі. Тематичні визначення також розкривають власні версії реєстру й визначення. Зберігайте ці версії та доступні дати спостережень під час порівняння результатів.

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