---
title: "Calculate the percentage change between an old value and a new value. Determines whether the change is an increase or decrease, the absolute change, and the percentage change. Essential for financial analysis (stock price changes, revenue growth), scientific measurements (before/ after experiments), performance benchmarks, and population statistics. A positive percentage indicates growth; negative indicates decline. Division by zero (old_value = 0) is handled gracefully."
method: POST
path: "/api/percentage_increase"
tags: ["general"]
---

# Calculate the percentage change between an old value and a new value. Determines whether the change is an increase or decrease, the absolute change, and the percentage change. Essential for financial analysis (stock price changes, revenue growth), scientific measurements (before/ after experiments), performance benchmarks, and population statistics. A positive percentage indicates growth; negative indicates decline. Division by zero (old_value = 0) is handled gracefully.

`POST /api/percentage_increase`

## Request

- Base URL: `https://calc.engineer`
- URL: `https://calc.engineer/api/percentage_increase`
- Auth: none declared

## Request body

- object
  - `old_value` number, required: The original or starting value
  - `new_value` number, required: The new or ending value

## Response `200`

Computed result for percentage_increase

- object
  - `result` object, required
    - `change` number, required: The signed difference (new_value - old_value)
    - `percentage_change` number, required: Percentage change from old to new value
    - `is_increase` boolean, required: True if new_value > old_value, false otherwise
    - `absolute_change` number, required: Absolute value of the change
  - `tool` string, required
  - `version` string, required
  - `computed_at` string, date-time, required
  - `chain` object, required
    - `feeds` unknown[]
      - unknown
    - `accepts_from` unknown[]
      - unknown

## Other responses

- `400`: Validation error or invalid JSON
- `404`: Tool not found

---

[API](https://skmtc.dev/calc/apis/calc-engineer-api.md) · [All operations](https://skmtc.dev/calc/apis/calc-engineer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calc/apis/calc-engineer-api/revisions/8830480ec488?raw)