{
  "openapi": "3.1.0",
  "info": {
    "title": "Kupić teraz czy odłożyć?",
    "version": "2026-08",
    "description": "Kupić teraz czy odłożyć zakup: ile dają odsetki z lokaty po podatku od odsetek (19%) od kwoty równej cenie, gdy zakup odłożyć o podaną liczbę miesięcy, wobec tego, o ile w tym czasie zmieni się cena, oraz po ilu miesiącach same odsetki pokryją cenę rzeczy (rosnącą i dzisiejszą). Kwoty w złotych, stawki jako ułamki. Kapitalizacja raz w roku, podatek 19% przy każdej kapitalizacji, w niepełnym roku odsetki proporcjonalne. Domyślne oprocentowanie: średnie oprocentowanie nowych depozytów gospodarstw domowych według NBP (2.94% za 2026-08); domyślna zmiana ceny: cel inflacyjny NBP (2.5% rocznie). Jedno oprocentowanie i jedna zmiana ceny na cały czas. „Za darmo” szukane do 100 lat; null znaczy, że nie w tym czasie (np. oprocentowanie po podatku nie przekracza wzrostu ceny)."
  },
  "servers": [
    {
      "url": "https://zyciewliczbach.pl"
    }
  ],
  "paths": {
    "/api/zakup/odlozenie": {
      "get": {
        "operationId": "zakupOdlozenie",
        "summary": "Odsetki z lokaty wobec wzrostu ceny przy odłożeniu zakupu i kiedy odsetki pokryją cenę",
        "parameters": [
          {
            "name": "cena",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number",
              "minimum": 1,
              "maximum": 10000000,
              "description": "Cena rzeczy w zł"
            }
          },
          {
            "name": "miesiace",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 480,
              "default": 6
            }
          },
          {
            "name": "oprocentowanie",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 20,
              "default": 2.94,
              "description": "Oprocentowanie rocznie w procentach przed podatkiem"
            }
          },
          {
            "name": "zmiana_ceny",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "minimum": -20,
              "maximum": 20,
              "default": 2.5,
              "description": "Zmiana ceny rocznie w procentach"
            }
          },
          {
            "name": "dzis",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Wynik (kwoty w zł, stawki jako ułamki)",
            "content": {
              "application/json": {
                "example": {
                  "dzis": "2026-11-07",
                  "cena": 5000,
                  "odlozenie_miesiecy": 6,
                  "oprocentowanie": 0.0294,
                  "podatek_od_odsetek": 0.19,
                  "oprocentowanie_po_podatku": 0.0238,
                  "zmiana_ceny_rocznie": 0.025,
                  "odsetki_po_podatku": 59.53,
                  "podatek_zaplacony": 13.96,
                  "cena_po_odlozeniu": 5062.11,
                  "zmiana_ceny": 62.11,
                  "roznica": -2.58,
                  "za_darmo_po_miesiacach": null,
                  "za_darmo_w_roku": null,
                  "cena_gdy_za_darmo": null,
                  "za_darmo_bez_wzrostu_ceny_po_miesiacach": 354,
                  "za_darmo_bez_wzrostu_ceny_w_roku": 2056,
                  "cena_gdy_za_darmo_bez_wzrostu_ceny": 10359.15,
                  "prog_oprocentowania": 0.0309
                }
              }
            }
          },
          "400": {
            "description": "Błędne parametry"
          },
          "429": {
            "description": "Za dużo zapytań, spróbuj za minutę"
          }
        }
      }
    }
  }
}