Profit Margin Calculator: API and MCP

Profit Margin Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: finance.profit-margin
Version: 1.0.0
Access: Free
Tool page: Profit Margin Calculator
Schema: GET /api/v1/tools/finance.profit-margin

Input

Field	Type	Constraints	Default	Description
`mode`	string	costPrice \| costMargin \| costMarkup \| priceMargin	costPrice	What to calculate
`cost`	number	> 0, ≤ 1,000,000,000,000		Cost
`price`	number	> 0, ≤ 1,000,000,000,000		Selling price · Before VAT
`margin`	number	≥ -1,000, ≤ 1,000		Profit margin (%) · Profit as a share of the price
`markup`	number	≥ -100, ≤ 100,000		Markup (%) · Profit as a share of the cost
`vatRate`	number	≥ 0, ≤ 100		VAT or sales tax rate (%) · Added on top of the price

Output

Field	Type	Description
`result`	number	Result
`cost`	number	Cost
`price`	number	Selling price (before VAT)
`profit`	number	Profit per unit
`margin`	number	Profit margin (%)
`markup`	number	Markup (on cost) (%)
`vat`	number	VAT
`priceWithVat`	number	Selling price with VAT

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/finance.profit-margin/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"mode":"costPrice","cost":30,"price":45},"locale":"en"}'

Example answer

{
  "output": {
    "result": 33.33333333333333,
    "cost": 30,
    "price": 45,
    "profit": 15,
    "margin": 33.33333333333333,
    "markup": 50
  },
  "steps": [
    {
      "id": "profit",
      "formula": "profit = price − cost",
      "substitution": "profit = 45.00 − 30.00",
      "value": 15
    },
    {
      "id": "margin",
      "formula": "margin = profit / price × 100",
      "substitution": "margin = 15.00 / 45.00 × 100",
      "value": 33.33333333333333,
      "unit": "%"
    },
    {
      "id": "markup",
      "formula": "markup = profit / cost × 100",
      "substitution": "markup = 15.00 / 30.00 × 100",
      "value": 50,
      "unit": "%"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/finance/profit-margin-calculator",
    "title": "Profit Margin Calculator"
  }
}