Фінансові моделі. Готові для Вашого коду.

Investboard / Довідник розробника

Фінансові моделі. Готові для Вашого коду.

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

Без облікового запису й ключа API
Калькулятори · Аналіз портфеля
REST · JSON · API v1

Каталог JSON ↗OpenAPI 3.1 (англійською) ↗Методи, формули та джерела →Усі калькулятори →

Один запит, один перевірний розрахунок.

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

cURL

curl 'https://investboard.com/api/v1/public/calculators/etf-sparplan' \
  -H 'Content-Type: application/json' \
  --data '{
  "inputs": {
    "monthly_rate": 500,
    "annual_return": 6,
    "annual_increase": 0,
    "years": 20
  },
  "locale": "uk",
  "asOf": "2026-10-15"
}'

Уривок відповіді · Повна відповідь також містить рядки за роками, джерела й обмеження

{
  "data": {
    "calculator": "etf-sparplan",
    "modelVersion": "2026-10-15.2",
    "inputs": {
      "initial_investment": 0,
      "monthly_rate": 500,
      "annual_increase": 0,
      "annual_return": 6,
      "years": 20,
      "include_tax_drag": false,
      "fondstyp": "AKTIENFONDS",
      "taxProfile": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      }
    },
    "asOf": "2026-10-15",
    "result": {
      "final_value": 232175.55,
      "total_contributions": 120000,
      "total_growth": 112175.55
    },
    "links": {
      "calculator": "https://investboard.com/uk/calculators/etf-savings-plan?lang=uk&initial_investment=0&monthly_rate=500&annual_increase=0&annual_return=6&years=20&include_tax_drag=false&fondstyp=AKTIENFONDS&taxProfile.bundesland=null&taxProfile.kirchensteuer=false&taxProfile.filing_status=single&taxProfile.sparerpauschbetrag_remaining=1000&asOf=2026-10-15&modelVersion=2026-10-15.2&via=api",
      "methodology": "https://investboard.com/calculators/etf-savings-plan",
      "documentation": "https://investboard.com/calculators/api"
    }
  },
  "error": null,
  "meta": {}
}

Запит і відповідь калькулятора.

POST /{slug}: Надішліть Content-Type: application/json та об’єкт inputs. Ідентифікатори калькуляторів не залежать від мови.
inputs: Для сум у євро використовуйте числа JSON, а не центи й не форматовані валютні рядки. Вхідні ставки задаються у відсоткових пунктах: 6 означає 6%. Невідомі поля відхиляються.
locale: Необов’язковий код мови: de/en/es/it/fr/nl/cs/pl/ru/uk; типово en. Вибирає мову методології та посилання на калькулятор у браузері; сам розрахунок не змінюється.
asOf: Необов’язкова дійсна календарна дата YYYY-MM-DD. За замовчуванням поточна дата UTC. Задає дату відліку для дат досягнення цілей накопичення, а не податковий рік.
data / error / meta: Успішний запит повертає data з error: null. Неуспішний запит повертає data: null і код із повідомленням усередині error. Вважайте відсутні результати недоступними, а не нульовими.
Одиниці результату: Суми в EUR. Ставки податку та звільнення й taxRate є частками (0,25 означає 25%). basiszins, effectiveWithdrawalRate і поля із закінченням _pct задано у відсоткових пунктах. Кількість років і місяців зберігає назви полів.

Виберіть модель під своє запитання.

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

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

Розрахуйте Kapitalertragsteuer (податок на доходи від капіталу), Solidaritätszuschlag (солідарну надбавку) і Kirchensteuer (церковний податок) із доходів від капіталу.

POST /api/v1/public/calculators/abgeltungssteuer

Приклад тіла запиту

{
  "inputs": {
    "kapitalertrag": 5000,
    "ertragsart": "general",
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "kapitalertrag": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 5000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "ertragsart": {
      "type": "string",
      "enum": [
        "general",
        "aktienverkauf",
        "dividende",
        "etf"
      ],
      "default": "general"
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "brutto_ertrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "fsa_offset": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "steuerpflichtiger_ertrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "kapitalertragsteuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "solidaritaetszuschlag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "kirchensteuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "gesamte_steuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "effektiver_steuersatz": {
      "type": "number",
      "description": "Fraction: 0.25 means 25%."
    },
    "netto_ertrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "kirchensteuer_rate": {
      "type": "number",
      "description": "Fraction: 0.25 means 25%."
    },
    "teilfreistellung_betrag": {
      "type": "number",
      "description": "EUR, not cents."
    }
  },
  "required": [
    "brutto_ertrag",
    "fsa_offset",
    "steuerpflichtiger_ertrag",
    "kapitalertragsteuer",
    "solidaritaetszuschlag",
    "kirchensteuer",
    "gesamte_steuer",
    "effektiver_steuersatz",
    "netto_ertrag",
    "kirchensteuer_rate",
    "teilfreistellung_betrag"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Що залишається від дивіденду після Abgeltungsteuer, солідарної надбавки й церковного податку?

POST /api/v1/public/calculators/netto-dividende

Приклад тіла запиту

{
  "inputs": {
    "brutto_dividende": 500,
    "quelle": "aktie",
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "brutto_dividende": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "quelle": {
      "type": "string",
      "enum": [
        "aktie",
        "etf_aktien",
        "mischfonds"
      ],
      "default": "aktie"
    },
    "isin": {
      "type": "string",
      "pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
      "description": "Optional issuer ISIN used for country-level withholding assumptions; not a live security lookup."
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "brutto_dividende": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "teilfreistellung_rate": {
      "type": "number",
      "description": "Fraction: 0.25 means 25%."
    },
    "teilfreistellung_betrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "steuerpflichtiger_betrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "steuer": {
      "type": "object",
      "properties": {
        "brutto_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "fsa_offset": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "steuerpflichtiger_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kapitalertragsteuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "solidaritaetszuschlag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kirchensteuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "gesamte_steuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "effektiver_steuersatz": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        },
        "netto_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kirchensteuer_rate": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        }
      },
      "required": [
        "brutto_ertrag",
        "fsa_offset",
        "steuerpflichtiger_ertrag",
        "kapitalertragsteuer",
        "solidaritaetszuschlag",
        "kirchensteuer",
        "gesamte_steuer",
        "effektiver_steuersatz",
        "netto_ertrag",
        "kirchensteuer_rate"
      ],
      "additionalProperties": false
    },
    "quellensteuer_rate": {
      "type": "number",
      "description": "Fraction: 0.25 means 25%."
    },
    "quellensteuer_betrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "anrechenbare_quellensteuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "erstattungsfaehige_quellensteuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "deutsche_reststeuer": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "quellensteuer_status": {
      "type": "string",
      "enum": [
        "credited",
        "fund_level",
        "none",
        "unavailable"
      ],
      "description": "unavailable means withholding was omitted because country assumptions are unavailable; none means no modeled investor withholding."
    },
    "netto_dividende": {
      "type": "number",
      "description": "EUR, not cents."
    }
  },
  "required": [
    "brutto_dividende",
    "teilfreistellung_rate",
    "teilfreistellung_betrag",
    "steuerpflichtiger_betrag",
    "steuer",
    "quellensteuer_rate",
    "quellensteuer_betrag",
    "anrechenbare_quellensteuer",
    "erstattungsfaehige_quellensteuer",
    "deutsche_reststeuer",
    "quellensteuer_status",
    "netto_dividende"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Розрахуйте авансовий податок за ETF і фондами за податкові роки з 2024 до 2026, кожен зі сплатою в січні наступного року.

POST /api/v1/public/calculators/vorabpauschale

Приклад тіла запиту

{
  "inputs": {
    "wert_jahresanfang": 10000,
    "wert_jahresende": 11500,
    "ausschuettungen": 0,
    "fondstyp": "AKTIENFONDS",
    "steuerjahr": 2025,
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "wert_jahresanfang": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 10000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "wert_jahresende": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 11500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "ausschuettungen": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "fondstyp": {
      "type": "string",
      "enum": [
        "AKTIENFONDS",
        "MISCHFONDS",
        "IMMOBILIENFONDS",
        "IMMOBILIENFONDS_AUSLAND",
        "SONSTIGE"
      ],
      "default": "AKTIENFONDS"
    },
    "steuerjahr": {
      "anyOf": [
        {
          "type": "number",
          "enum": [
            2023
          ]
        },
        {
          "type": "number",
          "enum": [
            2024
          ]
        },
        {
          "type": "number",
          "enum": [
            2025
          ]
        },
        {
          "type": "number",
          "enum": [
            2026
          ]
        }
      ],
      "default": 2025,
      "description": "Only years with published Basiszins in the model are accepted. Single-position, full-year holding."
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "basiszins": {
      "type": "number",
      "description": "Percentage points: 4 means 4%."
    },
    "basisertrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "wertsteigerung": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "vorabpauschale_brutto": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "teilfreistellung_rate": {
      "type": "number",
      "description": "Fraction: 0.25 means 25%."
    },
    "teilfreistellung_betrag": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "vorabpauschale_steuerpflichtig": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "steuer": {
      "type": "object",
      "properties": {
        "brutto_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "fsa_offset": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "steuerpflichtiger_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kapitalertragsteuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "solidaritaetszuschlag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kirchensteuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "gesamte_steuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "effektiver_steuersatz": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        },
        "netto_ertrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "kirchensteuer_rate": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        }
      },
      "required": [
        "brutto_ertrag",
        "fsa_offset",
        "steuerpflichtiger_ertrag",
        "kapitalertragsteuer",
        "solidaritaetszuschlag",
        "kirchensteuer",
        "gesamte_steuer",
        "effektiver_steuersatz",
        "netto_ertrag",
        "kirchensteuer_rate"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "basiszins",
    "basisertrag",
    "wertsteigerung",
    "vorabpauschale_brutto",
    "teilfreistellung_rate",
    "teilfreistellung_betrag",
    "vorabpauschale_steuerpflichtig",
    "steuer"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Який тип ETF дає більше капіталу після німецьких податків? Довгострокове порівняння з Vorabpauschale, частковим звільненням і неоподатковуваним лімітом заощадника.

POST /api/v1/public/calculators/thesaurierer-vs-ausschuetter

Приклад тіла запиту

{
  "inputs": {
    "initial_investment": 10000,
    "monthly_contribution": 300,
    "annual_return": 7,
    "distribution_yield": 2,
    "years": 20,
    "fondstyp": "AKTIENFONDS",
    "reinvest_distributions": true,
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "initial_investment": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 10000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthly_contribution": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 300,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annual_return": {
      "type": "number",
      "minimum": 1,
      "maximum": 15,
      "default": 7,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "distribution_yield": {
      "type": "number",
      "minimum": 0,
      "maximum": 6,
      "default": 2,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "years": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 20
    },
    "fondstyp": {
      "type": "string",
      "enum": [
        "AKTIENFONDS",
        "MISCHFONDS",
        "SONSTIGE"
      ],
      "default": "AKTIENFONDS"
    },
    "reinvest_distributions": {
      "type": "boolean",
      "default": true
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "yearly_data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "integer",
            "minimum": 0,
            "description": "Year index from the start of the projection."
          },
          "thesaurierer_value": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "thesaurierer_vorabpauschale_tax": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "ausschuetter_value": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "ausschuetter_distribution_tax": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "ausschuetter_distributions_gross": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "ausschuetter_distributions_net": {
            "type": "number",
            "description": "EUR, not cents."
          }
        },
        "required": [
          "year",
          "thesaurierer_value",
          "thesaurierer_vorabpauschale_tax",
          "ausschuetter_value",
          "ausschuetter_distribution_tax",
          "ausschuetter_distributions_gross",
          "ausschuetter_distributions_net"
        ],
        "additionalProperties": false
      }
    },
    "thesaurierer_final": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "ausschuetter_final": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "thesaurierer_advantage_eur": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "thesaurierer_advantage_pct": {
      "type": "number",
      "description": "Percentage points: 4 means 4%."
    },
    "thesaurierer_total_taxes": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "ausschuetter_total_taxes": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_contributions": {
      "type": "number",
      "description": "EUR, not cents."
    }
  },
  "required": [
    "yearly_data",
    "thesaurierer_final",
    "ausschuetter_final",
    "thesaurierer_advantage_eur",
    "thesaurierer_advantage_pct",
    "thesaurierer_total_taxes",
    "ausschuetter_total_taxes",
    "total_contributions"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

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

POST /api/v1/public/calculators/freistellungsauftrag

Приклад тіла запиту

{
  "inputs": {
    "brokers": [
      {
        "name": "Broker 1",
        "zinsen": 0,
        "dividenden": 0,
        "vorabpauschale": 0,
        "realisierte_gewinne": 0,
        "current_fsa": 0
      },
      {
        "name": "Broker 2",
        "zinsen": 0,
        "dividenden": 0,
        "vorabpauschale": 0,
        "realisierte_gewinne": 0,
        "current_fsa": 0
      }
    ],
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "brokers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60
          },
          "zinsen": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000000,
            "default": 0,
            "description": "EUR, numeric JSON value (not cents or a formatted string)."
          },
          "dividenden": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000000,
            "default": 0,
            "description": "EUR, numeric JSON value (not cents or a formatted string)."
          },
          "vorabpauschale": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000000,
            "default": 0,
            "description": "EUR, numeric JSON value (not cents or a formatted string)."
          },
          "realisierte_gewinne": {
            "type": "number",
            "minimum": 0,
            "maximum": 100000000,
            "default": 0,
            "description": "EUR, numeric JSON value (not cents or a formatted string)."
          },
          "current_fsa": {
            "type": "number",
            "minimum": 0,
            "maximum": 2000,
            "default": 0,
            "description": "EUR, numeric JSON value (not cents or a formatted string)."
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 6,
      "default": [
        {
          "name": "Broker 1",
          "zinsen": 0,
          "dividenden": 0,
          "vorabpauschale": 0,
          "realisierte_gewinne": 0,
          "current_fsa": 0
        },
        {
          "name": "Broker 2",
          "zinsen": 0,
          "dividenden": 0,
          "vorabpauschale": 0,
          "realisierte_gewinne": 0,
          "current_fsa": 0
        }
      ]
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "brokers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "expected_income": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "current_fsa": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "optimal_fsa": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "tax_with_current": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "tax_with_optimal": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "delta": {
            "type": "number",
            "description": "EUR, not cents."
          }
        },
        "required": [
          "name",
          "expected_income",
          "current_fsa",
          "optimal_fsa",
          "tax_with_current",
          "tax_with_optimal",
          "delta"
        ],
        "additionalProperties": false
      }
    },
    "total_expected_income": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_fsa_available": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_fsa_optimal": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_tax_current": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_tax_optimal": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "savings": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "warnings": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "over_limit"
                ]
              },
              "message": {
                "type": "string"
              },
              "allocated": {
                "type": "number",
                "description": "EUR, not cents."
              },
              "allowance": {
                "type": "number",
                "description": "EUR, not cents."
              }
            },
            "required": [
              "type",
              "message",
              "allocated",
              "allowance"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "under_utilised"
                ]
              },
              "message": {
                "type": "string"
              },
              "brokerIndex": {
                "type": "integer",
                "minimum": 0
              },
              "brokerName": {
                "type": "string"
              },
              "allocated": {
                "type": "number",
                "description": "EUR, not cents."
              },
              "expected": {
                "type": "number",
                "description": "EUR, not cents."
              }
            },
            "required": [
              "type",
              "message",
              "brokerIndex",
              "brokerName",
              "allocated",
              "expected"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "january_risk"
                ]
              },
              "message": {
                "type": "string"
              },
              "brokerIndex": {
                "type": "integer",
                "minimum": 0
              },
              "brokerName": {
                "type": "string"
              },
              "preTax": {
                "type": "number",
                "description": "EUR, not cents."
              },
              "allocated": {
                "type": "number",
                "description": "EUR, not cents."
              }
            },
            "required": [
              "type",
              "message",
              "brokerIndex",
              "brokerName",
              "preTax",
              "allocated"
            ],
            "additionalProperties": false
          }
        ]
      }
    }
  },
  "required": [
    "brokers",
    "total_expected_income",
    "total_fsa_available",
    "total_fsa_optimal",
    "total_tax_current",
    "total_tax_optimal",
    "savings",
    "warnings"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Розрахуйте капітал через 10, 20 або 30 років, за вибором із відрахуванням німецького податку Vorabpauschale.

POST /api/v1/public/calculators/etf-sparplan

Приклад тіла запиту

{
  "inputs": {
    "initial_investment": 0,
    "monthly_rate": 300,
    "annual_increase": 2,
    "annual_return": 7,
    "years": 20,
    "include_tax_drag": false,
    "fondstyp": "AKTIENFONDS",
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "initial_investment": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthly_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 300,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annual_increase": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "default": 2,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "annual_return": {
      "type": "number",
      "minimum": 1,
      "maximum": 15,
      "default": 7,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "years": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 20
    },
    "include_tax_drag": {
      "type": "boolean",
      "default": false
    },
    "fondstyp": {
      "type": "string",
      "enum": [
        "AKTIENFONDS",
        "MISCHFONDS",
        "SONSTIGE"
      ],
      "default": "AKTIENFONDS"
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "yearly_data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "integer",
            "minimum": 0,
            "description": "Year index from the start of the projection."
          },
          "contributions_cumulative": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "value_before_tax": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "value_after_tax": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "annual_contribution": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "vorabpauschale_tax": {
            "type": "number",
            "description": "EUR, not cents."
          }
        },
        "required": [
          "year",
          "contributions_cumulative",
          "value_before_tax",
          "value_after_tax",
          "annual_contribution",
          "vorabpauschale_tax"
        ],
        "additionalProperties": false
      }
    },
    "final_value": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_contributions": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_growth": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "total_taxes_paid": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "final_value_no_tax": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "tax_drag_eur": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "tax_drag_pct": {
      "type": "number",
      "description": "Percentage points: 4 means 4%."
    }
  },
  "required": [
    "yearly_data",
    "final_value",
    "total_contributions",
    "total_growth",
    "total_taxes_paid",
    "final_value_no_tax",
    "tax_drag_eur",
    "tax_drag_pct"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Яка фінансова подушка Вам потрібна?

POST /api/v1/public/calculators/notgroschen

Приклад тіла запиту

{
  "inputs": {
    "monthlyExpenses": 2500,
    "bufferMonths": 6,
    "currentSavings": 0,
    "monthlySavingsCapacity": 300,
    "parkingVehicle": "tagesgeld"
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "monthlyExpenses": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000000,
      "default": 2500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "bufferMonths": {
      "anyOf": [
        {
          "type": "number",
          "enum": [
            3
          ]
        },
        {
          "type": "number",
          "enum": [
            6
          ]
        },
        {
          "type": "number",
          "enum": [
            9
          ]
        },
        {
          "type": "number",
          "enum": [
            12
          ]
        }
      ],
      "default": 6
    },
    "currentSavings": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthlySavingsCapacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 300,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "parkingVehicle": {
      "type": "string",
      "enum": [
        "tagesgeld",
        "geldmarkt_etf",
        "festgeld_leiter"
      ],
      "default": "tagesgeld"
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "targetAmount": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "deficit": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "monthsToTarget": {
      "type": "integer",
      "minimum": 0,
      "description": "Months to target, capped at 600; zero with a positive deficit and no saving capacity does not mean funded."
    },
    "targetUnreachable": {
      "type": "boolean",
      "description": "The 600-month horizon was exhausted. Also inspect deficit and saving capacity when monthsToTarget is zero."
    },
    "targetDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "UTC modeled target date; only meaningful if the target is funded or reachable with positive saving capacity."
    },
    "expectedReturn": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "recommendedVehicle": {
      "type": "string",
      "enum": [
        "tagesgeld",
        "geldmarkt_etf",
        "festgeld_leiter"
      ]
    }
  },
  "required": [
    "targetAmount",
    "deficit",
    "monthsToTarget",
    "targetUnreachable",
    "targetDate",
    "expectedReturn",
    "recommendedVehicle"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

Калькулятор власних коштів на житлоeigenkapital

Скільки потрібно для Вашої нерухомості?

POST /api/v1/public/calculators/eigenkapital

Приклад тіла запиту

{
  "inputs": {
    "purchasePrice": 350000,
    "bundesland": "nordrhein-westfalen",
    "eigenkapitalQuote": 20,
    "currentSavings": 30000,
    "monthlySavingsCapacity": 500,
    "savingsReturnPct": 4
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "purchasePrice": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 350000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "bundesland": {
      "type": "string",
      "enum": [
        "baden-wuerttemberg",
        "bayern",
        "berlin",
        "brandenburg",
        "bremen",
        "hamburg",
        "hessen",
        "mecklenburg-vorpommern",
        "niedersachsen",
        "nordrhein-westfalen",
        "rheinland-pfalz",
        "saarland",
        "sachsen",
        "sachsen-anhalt",
        "schleswig-holstein",
        "thueringen"
      ],
      "default": "nordrhein-westfalen"
    },
    "eigenkapitalQuote": {
      "type": "number",
      "minimum": 10,
      "maximum": 40,
      "default": 20,
      "description": "Equity percentage points, e.g. 20 for 20%."
    },
    "currentSavings": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 30000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthlySavingsCapacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "savingsReturnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 8,
      "default": 4,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "nebenkostenTotal": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "nebenkostenBreakdown": {
      "type": "object",
      "properties": {
        "grunderwerbsteuer": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "notarGrundbuch": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "makler": {
          "type": "number",
          "description": "EUR, not cents."
        }
      },
      "required": [
        "grunderwerbsteuer",
        "notarGrundbuch",
        "makler"
      ],
      "additionalProperties": false
    },
    "eigenkapitalRequired": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "totalUpfront": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "deficit": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "monthsToTarget": {
      "type": "integer",
      "minimum": 0,
      "description": "Months to target, capped at 600; zero with a positive deficit and no saving capacity does not mean funded."
    },
    "targetUnreachable": {
      "type": "boolean",
      "description": "The 600-month horizon was exhausted. Also inspect deficit and saving capacity when monthsToTarget is zero."
    },
    "targetDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "UTC modeled target date; only meaningful if the target is funded or reachable with positive saving capacity."
    },
    "monthlyMortgageEstimate": {
      "type": "number",
      "description": "EUR, not cents."
    }
  },
  "required": [
    "nebenkostenTotal",
    "nebenkostenBreakdown",
    "eigenkapitalRequired",
    "totalUpfront",
    "deficit",
    "monthsToTarget",
    "targetUnreachable",
    "targetDate",
    "monthlyMortgageEstimate"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Чого бракує для Вашої пенсії?

POST /api/v1/public/calculators/rentenluecke

Приклад тіла запиту

{
  "inputs": {
    "currentAge": 35,
    "retirementAge": 67,
    "grossMonthlyIncome": 4000,
    "workingYearsSoFar": 10,
    "desiredRetirementIncome": 2500,
    "existingPrivateProvision": 0,
    "monthlyContribution": 300,
    "annualReturnPct": 6
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "currentAge": {
      "type": "integer",
      "minimum": 18,
      "maximum": 65,
      "default": 35
    },
    "retirementAge": {
      "type": "integer",
      "minimum": 55,
      "maximum": 70,
      "default": 67
    },
    "grossMonthlyIncome": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 4000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "workingYearsSoFar": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50,
      "default": 10
    },
    "desiredRetirementIncome": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 2500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "existingPrivateProvision": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthlyContribution": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 300,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annualReturnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 15,
      "default": 6,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "estimatedStatePension": {
      "type": "number",
      "description": "Estimated monthly state pension, EUR."
    },
    "monthlyGap": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "annualGap": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "capitalNeeded": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "capitalNeededAfterExisting": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "monthlySavingsNeeded": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "surplusOrDeficit": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "yearsUntilRetirement": {
      "type": "number",
      "description": "Elapsed years, possibly fractional."
    }
  },
  "required": [
    "estimatedStatePension",
    "monthlyGap",
    "annualGap",
    "capitalNeeded",
    "capitalNeededAfterExisting",
    "monthlySavingsNeeded",
    "surplusOrDeficit",
    "yearsUntilRetirement"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

Калькулятор плану зняттівentnahmeplan

На скільки вистачить Вашого капіталу?

POST /api/v1/public/calculators/entnahmeplan

Приклад тіла запиту

{
  "inputs": {
    "portfolioValue": 500000,
    "monthlyWithdrawal": 2000,
    "annualReturnPct": 5,
    "inflationPct": 2,
    "strategy": "constant_nominal",
    "percentageRate": 4,
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "portfolioValue": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 500000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthlyWithdrawal": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 2000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annualReturnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 15,
      "default": 5,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "inflationPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "default": 2,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "strategy": {
      "type": "string",
      "enum": [
        "constant_nominal",
        "constant_real",
        "percentage"
      ],
      "default": "constant_nominal"
    },
    "percentageRate": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 20,
      "default": 4,
      "description": "Annual withdrawal percentage points: 4 means 4%."
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "yearlyData": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "integer",
            "minimum": 0,
            "description": "Year index from the start of the projection."
          },
          "balanceStart": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "withdrawal": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "grossWithdrawal": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "taxPaid": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "growth": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "balanceEnd": {
            "type": "number",
            "description": "EUR, not cents."
          }
        },
        "required": [
          "year",
          "balanceStart",
          "withdrawal",
          "grossWithdrawal",
          "taxPaid",
          "growth",
          "balanceEnd"
        ],
        "additionalProperties": false
      }
    },
    "yearsUntilDepletion": {
      "type": [
        "number",
        "null"
      ],
      "description": "Null means no depletion within the modeled horizon; it does not show that the withdrawals last for life."
    },
    "totalWithdrawals": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "totalTaxPaid": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "effectiveWithdrawalRate": {
      "type": "number",
      "description": "Percentage points: 4 means 4%."
    },
    "remainingAt80": {
      "type": [
        "number",
        "null"
      ],
      "description": "EUR at age 80; null if that age is outside the modeled age/horizon."
    },
    "remainingAt90": {
      "type": [
        "number",
        "null"
      ],
      "description": "EUR at age 90; null if that age is outside the modeled age/horizon."
    }
  },
  "required": [
    "yearlyData",
    "yearsUntilDepletion",
    "totalWithdrawals",
    "totalTaxPaid",
    "effectiveWithdrawalRate",
    "remainingAt80",
    "remainingAt90"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

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

Розрахуйте неоподатковувані ліміти й податкові зобов’язання

POST /api/v1/public/calculators/schenkungsteuer

Приклад тіла запиту

{
  "inputs": {
    "relationship": "child",
    "giftAmount": 100000,
    "previousGifts10y": 0,
    "numberOfDonors": 1,
    "optimizeOverTime": false,
    "totalToTransfer": 100000
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "relationship": {
      "type": "string",
      "enum": [
        "spouse",
        "child",
        "grandchild",
        "sibling",
        "other"
      ],
      "default": "child"
    },
    "giftAmount": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 100000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "previousGifts10y": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "numberOfDonors": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2,
      "default": 1
    },
    "optimizeOverTime": {
      "type": "boolean",
      "default": false
    },
    "totalToTransfer": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000,
      "default": 100000,
      "description": "Used only when optimizeOverTime is true. Prior gifts are not modeled by optimization."
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "freibetrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "totalFreibetrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "taxableAmount": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "taxRate": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        },
        "taxDue": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "netGiftAmount": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "steuerklasse": {
          "type": "string",
          "enum": [
            "I",
            "II",
            "III"
          ]
        },
        "optimalSchedule": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "year": {
                "type": "integer",
                "minimum": 0,
                "description": "Year index from the start of the projection."
              },
              "amount": {
                "type": "number",
                "description": "EUR, not cents."
              },
              "taxFree": {
                "type": "boolean"
              },
              "taxDue": {
                "type": "number",
                "description": "EUR, not cents."
              }
            },
            "required": [
              "year",
              "amount",
              "taxFree",
              "taxDue"
            ],
            "additionalProperties": false
          }
        },
        "totalTaxSaved": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "yearsNeeded": {
          "type": "number",
          "description": "Elapsed years, possibly fractional."
        }
      },
      "required": [
        "freibetrag",
        "totalFreibetrag",
        "taxableAmount",
        "taxRate",
        "taxDue",
        "netGiftAmount",
        "steuerklasse",
        "optimalSchedule",
        "totalTaxSaved",
        "yearsNeeded"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "freibetrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "totalFreibetrag": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "taxableAmount": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "taxRate": {
          "type": "number",
          "description": "Fraction: 0.25 means 25%."
        },
        "taxDue": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "netGiftAmount": {
          "type": "number",
          "description": "EUR, not cents."
        },
        "steuerklasse": {
          "type": "string",
          "enum": [
            "I",
            "II",
            "III"
          ]
        }
      },
      "required": [
        "freibetrag",
        "totalFreibetrag",
        "taxableAmount",
        "taxRate",
        "taxDue",
        "netGiftAmount",
        "steuerklasse"
      ],
      "additionalProperties": false
    }
  ],
  "description": "Scheduling mode adds optimalSchedule, totalTaxSaved and yearsNeeded. Single-gift mode returns the base fields."
}

Відкрити калькулятор →

Калькулятор дитячого брокерського рахункуjunior-depot

До якої суми зростуть регулярні вкладення дитини?

POST /api/v1/public/calculators/junior-depot

Приклад тіла запиту

{
  "inputs": {
    "childAge": 0,
    "targetAge": 18,
    "monthlyContribution": 100,
    "initialDeposit": 0,
    "annualReturnPct": 7,
    "useKindergeld": false,
    "hasNVBescheinigung": false,
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "childAge": {
      "type": "integer",
      "minimum": 0,
      "maximum": 17,
      "default": 0
    },
    "targetAge": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 18
    },
    "monthlyContribution": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 100,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "initialDeposit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 0,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annualReturnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 15,
      "default": 7,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "useKindergeld": {
      "type": "boolean",
      "default": false
    },
    "hasNVBescheinigung": {
      "type": "boolean",
      "default": false
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "yearlyData": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": "integer",
            "minimum": 0,
            "description": "Year index from the start of the projection."
          },
          "age": {
            "type": "integer",
            "description": "Child age in years."
          },
          "contributionsCumulative": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "valueGross": {
            "type": "number",
            "description": "EUR, not cents."
          },
          "vorabpauschaleTax": {
            "type": "number",
            "description": "EUR, not cents."
          }
        },
        "required": [
          "year",
          "age",
          "contributionsCumulative",
          "valueGross",
          "vorabpauschaleTax"
        ],
        "additionalProperties": false
      }
    },
    "finalValueGross": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "totalContributions": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "totalGrowth": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "finalValueAfterTax": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "taxOnSale": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "vorabpauschaleCredited": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "nvSavings": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "kindergeldEquivalent": {
      "type": "string",
      "description": "Display text; use the numeric result fields for arithmetic."
    }
  },
  "required": [
    "yearlyData",
    "finalValueGross",
    "totalContributions",
    "totalGrowth",
    "finalValueAfterTax",
    "taxOnSale",
    "vorabpauschaleCredited",
    "nvSavings",
    "kindergeldEquivalent"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

Калькулятор FIREfire-rechner

Коли Ви досягнете фінансової незалежності?

POST /api/v1/public/calculators/fire-rechner

Приклад тіла запиту

{
  "inputs": {
    "monthlyExpenses": 2000,
    "currentPortfolio": 100000,
    "monthlyContribution": 1500,
    "annualReturnPct": 7,
    "withdrawalRatePct": 3.5,
    "currentAge": 30,
    "partTimeIncome": 1000,
    "targetRetirementAge": 55,
    "variant": "regular",
    "taxProfile": {
      "bundesland": null,
      "kirchensteuer": false,
      "filing_status": "single",
      "sparerpauschbetrag_remaining": 1000
    }
  },
  "locale": "uk"
}

Схема вихідних даних · Значення за замовчуванням і допустимі діапазони (англійською)

{
  "type": "object",
  "properties": {
    "monthlyExpenses": {
      "type": "number",
      "minimum": 1,
      "maximum": 100000000,
      "default": 2000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "currentPortfolio": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 100000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "monthlyContribution": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 1500,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "annualReturnPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 15,
      "default": 7,
      "description": "Annual percentage points: 6 means 6%, not 0.06."
    },
    "withdrawalRatePct": {
      "type": "number",
      "minimum": 2,
      "maximum": 6,
      "default": 3.5
    },
    "currentAge": {
      "type": "integer",
      "minimum": 18,
      "maximum": 70,
      "default": 30
    },
    "partTimeIncome": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "default": 1000,
      "description": "EUR, numeric JSON value (not cents or a formatted string)."
    },
    "targetRetirementAge": {
      "type": "integer",
      "minimum": 19,
      "maximum": 80,
      "default": 55
    },
    "variant": {
      "type": "string",
      "enum": [
        "regular",
        "coast",
        "barista"
      ],
      "default": "regular"
    },
    "taxProfile": {
      "type": "object",
      "properties": {
        "bundesland": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen"
              ]
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kirchensteuer": {
          "type": "boolean",
          "default": false
        },
        "filing_status": {
          "type": "string",
          "enum": [
            "single",
            "joint"
          ],
          "default": "single"
        },
        "sparerpauschbetrag_remaining": {
          "type": "number",
          "minimum": 0,
          "maximum": 2000,
          "default": 1000,
          "description": "Remaining EUR allowance for single-year tax calculations. Multi-year projections use the full annual statutory allowance based on filing_status."
        }
      },
      "default": {
        "bundesland": null,
        "kirchensteuer": false,
        "filing_status": "single",
        "sparerpauschbetrag_remaining": 1000
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false,
  "description": "Coast FIRE requires a future target age and a nominal return above 2% (the model inflation assumption)."
}

Схема результату · Одиниці та значення null (англійською)

{
  "type": "object",
  "properties": {
    "fireNumber": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "fireNumberPreTax": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "yearsToFire": {
      "type": [
        "number",
        "null"
      ],
      "description": "Null means the target was not reached within the 50-year modeled horizon."
    },
    "monthlyContributionNeeded": {
      "type": "number",
      "description": "EUR, not cents."
    },
    "coastFireNumber": {
      "type": [
        "number",
        "null"
      ],
      "description": "Null when Coast FIRE does not apply."
    },
    "coastFireAge": {
      "type": [
        "number",
        "null"
      ],
      "description": "Absolute age in years; null when Coast FIRE age is not applicable, including an already-funded portfolio."
    },
    "baristaIncomeNeeded": {
      "type": [
        "number",
        "null"
      ],
      "description": "Annual part-time income in EUR; null when the Barista calculation does not apply."
    },
    "baristaPortfolioNeeded": {
      "type": [
        "number",
        "null"
      ],
      "description": "Null when the Barista calculation does not apply."
    },
    "effectiveMultiplier": {
      "type": "number",
      "description": "Multiple of annual expenses, not a percentage or EUR amount."
    }
  },
  "required": [
    "fireNumber",
    "fireNumberPreTax",
    "yearsToFire",
    "monthlyContributionNeeded",
    "coastFireNumber",
    "coastFireAge",
    "baristaIncomeNeeded",
    "baristaPortfolioNeeded",
    "effectiveMultiplier"
  ],
  "additionalProperties": false
}

Відкрити калькулятор →

Надайте позиції. Запитайте про весь портфель.

Аналізуйте портфель без облікового запису Investboard. Передайте ISIN і ваги або ринкову вартість. Один запит повертає перетини, базові компанії, концентрацію, сектори, географію, валюти, розподіл і поточні витрати фондів. Окремі кінцеві точки додають сценарії витрат, галузі й теми, географію виторгу, порівняння до та після, бюджети поповнення, альтернативи ETF, кризові сценарії й історичне відтворення.

Методологія та обмеження →Каталог портфеля ↗OpenAPI портфеля (англійською) ↗Посібник агента в Markdown (англійською) ↗

Приклад запиту · Ваги задаються частками

curl 'https://investboard.com/api/v1/public/portfolio-analysis' \
  -H 'Content-Type: application/json' \
  --data '{
  "basis": "weights",
  "baseCurrency": "EUR",
  "holdings": [
    {
      "isin": "IE00B4L5Y983",
      "weight": 0.6
    },
    {
      "isin": "IE00B3XXRP09",
      "weight": 0.3
    },
    {
      "assetClass": "cash",
      "currency": "EUR",
      "weight": 0.1
    }
  ],
  "locale": "uk"
}'

Використовуйте basis: weights із додатними частками із сумою 1 або basis: values із додатною ринковою вартістю, уже перерахованою в baseCurrency. Не змішуйте ваги з вартістю або вихідні валюти. Повторювані ISIN об’єднуються за брокерами. Грошові кошти використовують assetClass: cash і валюту. Запити знімка та стрес-аналізу з вагами повертають грошові результати null. Історичне відтворення використовує явні гіпотетичні суми вкладень.

Приклад запиту · Вартість уже перерахована в EUR

{
  "basis": "values",
  "baseCurrency": "EUR",
  "holdings": [
    {
      "isin": "IE00B4L5Y983",
      "value": 6000
    },
    {
      "isin": "IE00B3XXRP09",
      "value": 3000
    },
    {
      "assetClass": "cash",
      "currency": "EUR",
      "value": 1000
    }
  ],
  "locale": "uk"
}

Додатковий аналіз · Окремі запити

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

Довгостроковий вплив витрат
Галузі й теми
Географія виручки
Порівняти зміни портфеля
Цільовий розподіл і планування внеску
Порівняти альтернативи ETF
Кризові стрес-сценарії
Історичне відтворення портфеля

Прочитайте стан розділу перед числами.

Кожен розділ містить status, reasons і data. HTTP 200 може включати часткові або недоступні розділи. Вісім кінцевих точок знімка позначають решту розділів як not_requested. Окремі кінцеві точки мають власну схему введення й повертають capability та analysis; перевіряйте analysis.status. Невідомі позиції залишаються в розподілі як unknown і у знаменнику портфеля. Розділи базових акцій описують розпізнану сукупність; концентрація не показується, якщо хоча б одну позицію не розпізнано.

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

Базова валютна залежність моделюється за країнами компаній і валютними хеджами, зазначеними фондами. Вона відрізняється від heldCurrencies, що описує розпізнані валюти лістингу та грошові кошти. Це не валюти виторгу й не виміряна чутливість до валютних курсів.

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

Результати супроводжуються датами складу й охопленням. Відсутні дані залишаються невідомими. Порожній перелік перетинів за неповного складу фондів не доводить відсутності перетинів; пари нижче 1% пропускаються. HHI, ефективна кількість емітентів і названі емітенти не показуються за охоплення емітентів нижче 80%. Кількість повернутих позицій і компаній обмежено limit; tailWeight зберігає пропущену частку.

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

До 25 наданих позицій на знімок і 16 KiB на запит. Для аналізу портфеля діє окремий спільний ліміт 60 одиниць на IP за хвилину: по одній на надану позицію (обидва знімки для compare), плюс 25 зарезервованих одиниць компаній для revenue-geography. Історичне відтворення коштує дві одиниці на позицію; альтернативи ETF по дві на вихідний фонд або кандидата з резервом на десять кандидатів під час читання каталогу. cost-drag і discovery коштують одну. Під час збоїв обмеження діє за можливості. Дотримуйтеся Retry-After за HTTP 429. Міждоменні клієнти використовують credentials: omit.

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

Схеми введення, результатів і довідник кінцевих точок

Спільна схема вихідних даних (англійською)

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "baseCurrency": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$",
          "default": "EUR"
        },
        "locale": {
          "type": "string",
          "enum": [
            "de",
            "en",
            "es",
            "it",
            "fr",
            "nl",
            "cs",
            "pl",
            "ru",
            "uk"
          ],
          "default": "en"
        },
        "limit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100,
          "default": 50,
          "description": "Maximum returned companies and underlying positions; tails retain omitted weight."
        },
        "basis": {
          "type": "string",
          "enum": [
            "weights"
          ],
          "default": "weights"
        },
        "holdings": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "isin": {
                    "type": "string",
                    "pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$"
                  },
                  "weight": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "exclusiveMinimum": 0,
                    "description": "Share of the entire submitted portfolio: 0.6 means 60%."
                  }
                },
                "required": [
                  "isin",
                  "weight"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "assetClass": {
                    "type": "string",
                    "enum": [
                      "cash"
                    ]
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3}$"
                  },
                  "weight": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "exclusiveMinimum": 0,
                    "description": "Share of the entire submitted portfolio: 0.6 means 60%."
                  }
                },
                "required": [
                  "assetClass",
                  "currency",
                  "weight"
                ],
                "additionalProperties": false
              }
            ]
          },
          "minItems": 1,
          "maxItems": 25
        }
      },
      "required": [
        "holdings"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "baseCurrency": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$",
          "default": "EUR"
        },
        "locale": {
          "type": "string",
          "enum": [
            "de",
            "en",
            "es",
            "it",
            "fr",
            "nl",
            "cs",
            "pl",
            "ru",
            "uk"
          ],
          "default": "en"
        },
        "limit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100,
          "default": 50,
          "description": "Maximum returned companies and underlying positions; tails retain omitted weight."
        },
        "basis": {
          "type": "string",
          "enum": [
            "values"
          ]
        },
        "holdings": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "isin": {
                    "type": "string",
                    "pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$"
                  },
                  "value": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100000000,
                    "description": "Market value already converted to baseCurrency. Never a native-currency amount."
                  }
                },
                "required": [
                  "isin",
                  "value"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "assetClass": {
                    "type": "string",
                    "enum": [
                      "cash"
                    ]
                  },
                  "currency": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3}$"
                  },
                  "value": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 100000000,
                    "description": "Market value already converted to baseCurrency. Never a native-currency amount."
                  }
                },
                "required": [
                  "assetClass",
                  "currency",
                  "value"
                ],
                "additionalProperties": false
              }
            ]
          },
          "minItems": 1,
          "maxItems": 25
        }
      },
      "required": [
        "basis",
        "holdings"
      ],
      "additionalProperties": false
    }
  ]
}

Повна схема відповіді (англійською)

{
  "type": "object",
  "properties": {
    "modelVersion": {
      "type": "string"
    },
    "computedAt": {
      "type": "string",
      "format": "date-time"
    },
    "baseCurrency": {
      "type": "string"
    },
    "basis": {
      "type": "string",
      "enum": [
        "weights",
        "values"
      ]
    },
    "totalValue": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 0
    },
    "resolvedPortfolioWeight": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "constituentsAsOf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Oldest known fund-constituent date; null when unavailable. Not the date of all reference data."
    },
    "holdings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "isin": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "weight": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "assetClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "resolved",
              "unresolved"
            ]
          }
        },
        "required": [
          "isin",
          "name",
          "weight",
          "value",
          "assetClass",
          "status"
        ],
        "additionalProperties": false
      }
    },
    "analyses": {
      "type": "object",
      "properties": {
        "allocation": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "scope": {
                  "type": "string",
                  "enum": [
                    "whole_portfolio"
                  ]
                },
                "coverage": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "buckets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1,
                        "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0,
                        "description": "Amount in baseCurrency; null for weight-only requests."
                      }
                    },
                    "required": [
                      "key",
                      "weight",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "scope",
                "coverage",
                "buckets"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "overlap": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "method": {
                  "type": "string",
                  "enum": [
                    "sum_minimum_constituent_weights"
                  ]
                },
                "fundCount": {
                  "type": "integer",
                  "minimum": 0
                },
                "pairs": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "fundA": {
                        "type": "string"
                      },
                      "fundB": {
                        "type": "string"
                      },
                      "isinA": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "isinB": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "overlap": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1,
                        "description": "Sum of the smaller constituent weights in the two funds, not a percentage of the portfolio."
                      },
                      "sharedCount": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "sharedTail": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "properties": {
                          "count": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "weight": {
                            "type": "number",
                            "minimum": 0,
                            "maximum": 1
                          }
                        },
                        "required": [
                          "count",
                          "weight"
                        ],
                        "additionalProperties": false,
                        "description": "Shared constituents beyond the returned list; weight uses the same overlap measure as the headline."
                      },
                      "sharedHoldings": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "weightInA": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            "weightInB": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "weightInA",
                            "weightInB"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "fundA",
                      "fundB",
                      "isinA",
                      "isinB",
                      "overlap",
                      "sharedCount",
                      "sharedTail",
                      "sharedHoldings"
                    ],
                    "additionalProperties": false
                  }
                },
                "funds": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "isin": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "full",
                          "partial",
                          "none"
                        ]
                      },
                      "coveredWeight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "asOf": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "isin",
                      "name",
                      "status",
                      "coveredWeight",
                      "asOf"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "method",
                "fundCount",
                "pairs",
                "funds"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "look-through": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "scope": {
                  "type": "string",
                  "enum": [
                    "equities"
                  ]
                },
                "positions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "isin": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0
                      },
                      "sector": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "region": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "provenance": {
                        "type": "object",
                        "properties": {
                          "direct": {
                            "type": "number",
                            "minimum": 0,
                            "maximum": 1
                          },
                          "viaFunds": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "fund": {
                                  "type": "string"
                                },
                                "weight": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "shareInFund": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                }
                              },
                              "required": [
                                "fund",
                                "weight",
                                "shareInFund"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "direct",
                          "viaFunds"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "isin",
                      "name",
                      "weight",
                      "value",
                      "sector",
                      "region",
                      "provenance"
                    ],
                    "additionalProperties": false
                  }
                },
                "positionCount": {
                  "type": "integer",
                  "minimum": 0
                },
                "unresolvedFundWeight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Whole-portfolio share in undissolved equity fund remainders; these are not named companies."
                },
                "tailWeight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "funds": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "isin": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "full",
                          "partial",
                          "none"
                        ]
                      },
                      "coveredWeight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "asOf": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "isin",
                      "name",
                      "status",
                      "coveredWeight",
                      "asOf"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "scope",
                "positions",
                "positionCount",
                "unresolvedFundWeight",
                "tailWeight",
                "funds"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "concentration": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "scope": {
                  "type": "string",
                  "enum": [
                    "equities"
                  ]
                },
                "coverage": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "issuers": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "issuerId": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    },
                    "required": [
                      "issuerId",
                      "name",
                      "weight"
                    ],
                    "additionalProperties": false
                  }
                },
                "issuerCount": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "minimum": 0
                },
                "tailWeight": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 1
                },
                "largestIssuer": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "issuerId": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "weight": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1
                    }
                  },
                  "required": [
                    "issuerId",
                    "name",
                    "weight"
                  ],
                  "additionalProperties": false
                },
                "hhi": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Herfindahl index over the equity issuer book; withheld below 80% coverage."
                },
                "effectiveN": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "description": "Effective issuer count; withheld below 80% coverage."
                }
              },
              "required": [
                "scope",
                "coverage",
                "issuers",
                "issuerCount",
                "tailWeight",
                "largestIssuer",
                "hhi",
                "effectiveN"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "sectors": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "scope": {
                  "type": "string",
                  "enum": [
                    "equities"
                  ]
                },
                "portfolioShare": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Equity share of the entire submitted portfolio that this dimension evaluates."
                },
                "coverage": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Classified share of this dimension's equity population."
                },
                "buckets": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1,
                        "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0,
                        "description": "Amount in baseCurrency; null for weight-only requests."
                      }
                    },
                    "required": [
                      "key",
                      "weight",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "scope",
                "portfolioShare",
                "coverage",
                "buckets"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "geography": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "countries": {
                  "type": "object",
                  "properties": {
                    "scope": {
                      "type": "string",
                      "enum": [
                        "equities"
                      ]
                    },
                    "portfolioShare": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Equity share of the entire submitted portfolio that this dimension evaluates."
                    },
                    "coverage": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Classified share of this dimension's equity population."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "weight": {
                            "type": "number",
                            "minimum": 0,
                            "maximum": 1,
                            "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                          },
                          "value": {
                            "type": [
                              "number",
                              "null"
                            ],
                            "minimum": 0,
                            "description": "Amount in baseCurrency; null for weight-only requests."
                          }
                        },
                        "required": [
                          "key",
                          "weight",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "scope",
                    "portfolioShare",
                    "coverage",
                    "buckets"
                  ],
                  "additionalProperties": false
                },
                "regions": {
                  "type": "object",
                  "properties": {
                    "scope": {
                      "type": "string",
                      "enum": [
                        "equities"
                      ]
                    },
                    "portfolioShare": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Equity share of the entire submitted portfolio that this dimension evaluates."
                    },
                    "coverage": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Classified share of this dimension's equity population."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "weight": {
                            "type": "number",
                            "minimum": 0,
                            "maximum": 1,
                            "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                          },
                          "value": {
                            "type": [
                              "number",
                              "null"
                            ],
                            "minimum": 0,
                            "description": "Amount in baseCurrency; null for weight-only requests."
                          }
                        },
                        "required": [
                          "key",
                          "weight",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "scope",
                    "portfolioShare",
                    "coverage",
                    "buckets"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "countries",
                "regions"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "currencies": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "equityExposure": {
                  "type": "object",
                  "properties": {
                    "scope": {
                      "type": "string",
                      "enum": [
                        "equities"
                      ]
                    },
                    "portfolioShare": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Equity share of the entire submitted portfolio that this dimension evaluates."
                    },
                    "coverage": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 1,
                      "description": "Classified share of this dimension's equity population."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "weight": {
                            "type": "number",
                            "minimum": 0,
                            "maximum": 1,
                            "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                          },
                          "value": {
                            "type": [
                              "number",
                              "null"
                            ],
                            "minimum": 0,
                            "description": "Amount in baseCurrency; null for weight-only requests."
                          }
                        },
                        "required": [
                          "key",
                          "weight",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "scope",
                    "portfolioShare",
                    "coverage",
                    "buckets"
                  ],
                  "additionalProperties": false
                },
                "heldCurrencies": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1,
                        "description": "Share of the entire submitted portfolio, including unresolved holdings in the denominator."
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0,
                        "description": "Amount in baseCurrency; null for weight-only requests."
                      }
                    },
                    "required": [
                      "key",
                      "weight",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "description": "Resolved listing currencies and caller-stated cash currencies; separate from underlying exposure."
                },
                "hedgedFunds": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "isin": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "currency": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      }
                    },
                    "required": [
                      "isin",
                      "name",
                      "currency",
                      "weight"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "equityExposure",
                "heldCurrencies",
                "hedgedFunds"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        },
        "costs": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial",
                "unavailable",
                "not_requested"
              ]
            },
            "reasons": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "unresolved_holdings",
                  "provider_unavailable",
                  "incomplete_coverage",
                  "no_equities",
                  "fewer_than_two_funds"
                ]
              }
            },
            "data": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "scope": {
                  "type": "string",
                  "enum": [
                    "ongoing_fund_charges"
                  ]
                },
                "coveredPortfolioWeight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "fundPortfolioWeight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "unknownPortfolioWeight": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1
                },
                "weightedTer": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "description": "TER fraction on the covered fund portion, not on the entire portfolio. 0.002 means 0.2%."
                },
                "knownAnnualCost": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "description": "Known fund charges in baseCurrency; a subtotal when coverage is incomplete. Null for weight-only input."
                },
                "positions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "isin": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "weight": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "ter": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0
                      },
                      "annualCost": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "minimum": 0
                      }
                    },
                    "required": [
                      "isin",
                      "name",
                      "weight",
                      "ter",
                      "annualCost"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "scope",
                "coveredPortfolioWeight",
                "fundPortfolioWeight",
                "unknownPortfolioWeight",
                "weightedTer",
                "knownAnnualCost",
                "positions"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "reasons",
            "data"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "allocation",
        "overlap",
        "look-through",
        "concentration",
        "sectors",
        "geography",
        "currencies",
        "costs"
      ],
      "additionalProperties": false
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "links": {
      "type": "object",
      "properties": {
        "documentation": {
          "type": "string",
          "format": "uri"
        },
        "catalog": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "documentation",
        "catalog"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "modelVersion",
    "computedAt",
    "baseCurrency",
    "basis",
    "totalValue",
    "resolvedPortfolioWeight",
    "constituentsAsOf",
    "holdings",
    "analyses",
    "assumptions",
    "limitations",
    "links"
  ],
  "additionalProperties": false
}

Розподіл активів

POST /api/v1/public/portfolio-analysis/allocation

Калькулятор	Завдання
abgeltungssteuer	Оцінити німецький податок на доходи від капіталу, продаж акцій або прибуток фондів акцій.
netto-dividende	Перетворити дивіденд до податків на чистий дохід із необов’язковими припущеннями про утримання за країною.
vorabpauschale	Оцінити авансовий податок на одну позицію фонду, утримувану повний рік.
thesaurierer-vs-ausschuetter	Порівняти змодельований капітал накопичувальних і розподільчих фондів.
freistellungsauftrag	Розподілити річний неоподатковуваний ліміт заощадника між рядками брокерів, не більш як шістьма.
etf-sparplan	Розрахувати сценарій регулярних вкладень в ETF із необов’язковим змодельованим податковим вилученням.
notgroschen	Визначити розмір резервного фонду й змоделювати час накопичення.
eigenkapital	Оцінити початкові власні кошти для нерухомості, витрати купівлі та строк накопичення.
rentenluecke	Оцінити розрив державної пенсії Німеччини й накопичення для його покриття.
entnahmeplan	Змоделювати зняття з портфеля, податок і вичерпання в межах горизонту моделі.
schenkungsteuer	Оцінити податок на дарування або розподілити подарунки за вікнами неоподатковуваних лімітів без попередніх подарунків.
junior-depot	Розрахувати сценарій дитячого інвестиційного рахунку з модельованими опціями Kindergeld і NV.
fire-rechner	Оцінити цілі Regular, Coast або Barista FIRE у сьогоднішніх євро.

Один запит, один перевірний розрахунок.

Запит і відповідь калькулятора.

Виберіть модель під своє запитання.

Надайте позиції. Запитайте про весь портфель.

Додатковий аналіз · Окремі запити

Прочитайте стан розділу перед числами.

Від запитання до відповідної моделі.

Порівняйте припущення поруч.

Читабельні посилання, поточні дані.

Поверніть розрахунок людині.

Невеликі запити. Явні ліміти.