> For the complete documentation index, see [llms.txt](/llms.txt).
[◆ miniwebtool /api](/)
[Tools](/tools/) [Docs](/docs/) [Reference](/v1/docs) [Pricing](/#pricing) [Log in](/dashboard/login/) [Start free](/billing/checkout/?plan=free)
- [Home](/)
- ›
- [Tools](/tools/)
- ›
- [Finance](/tools/#finance)
- ›
- Profit Calculator API

# Profit Calculator API

finance 2 credits / call v2026-04-22
Solve profit, margin, markup, revenue, or cost from the known values.
Use this endpoint to add Profit Calculator to your app, site, workflow, or agent without rebuilding formulas, validation, examples, and docs.
Prefer the browser version? [Open the Profit Calculator on miniwebtool.com](https://miniwebtool.com/profit-calculator/).
[Start Starter →](/billing/checkout/?plan=starter) Requires Starter+ · $29/mo
Starts on Starter
Free keys can view docs and examples, but calls to this endpoint require Starter or higher.
[Start Starter →](/billing/checkout/?plan=starter)
What this saves
Skip a custom implementation, validation rules, examples, OpenAPI shape, billing checks, and support copy for this utility.
Where it fits
Product forms, calculator pages, finance content, education flows, support tools, automations, and agent actions.
How to evaluate
Inspect the required fields, try the hosted playground, then copy cURL, Python, or Node code into your integration.

### Endpoint

```text
POST https://api.miniwebtool.com/v1/tools/profit-calculator/run
```

### Request body

Field
Type
Req.
`calc_mode`
margin_from_values | profit_from_margin | profit_from_markup | revenue_from_margin | revenue_from_markup | cost_from_margin | cost_from_markup
`str`
—
`revenue`
`float | None`
—
`cost`
`float | None`
—
`margin_percent`
`float | None`
—
`markup_percent`
`float | None`
—
`precision`
`int`
—

### Cost & access

- 2 credits per successful call.
- Starts on: Starter or higher.
- Max payload: 65536 bytes.
- Privacy mode:`hash_only`
- Available on: starter, pro, business, scale

### Response envelope

```text
{
  "request_id": "01K...",
  "tool": "profit-calculator",
  "tool_version": "2026-04-22",
  "credits_used": 2,
  "result": {... }
}
```

### Try it

API key *
Stored only in this browser tab. Playground test key is prefilled and only works on this page. [Get a live key →](/billing/checkout/?plan=starter)
calc_mode (str) margin_from_values profit_from_margin profit_from_markup revenue_from_margin revenue_from_markup cost_from_margin cost_from_markup
margin_from_values | profit_from_margin | profit_from_markup | revenue_from_margin | revenue_from_markup | cost_from_margin | cost_from_markup
revenue (float | None)
cost (float | None)
margin_percent (float | None)
markup_percent (float | None)
precision (int)
Send request →
Response copy body
This endpoint starts on Starter
Your key is valid, but its current plan cannot call`profit-calculator`. Upgrade to Starter or higher to run this tool.
[Start Starter →](/billing/checkout/?plan=starter) [Compare plans](/#pricing)

```text

```

Response headers

```text

```

### Code examples

cURL Python JavaScript PHP Ruby Go Java
copy

```text
curl -X POST https://api.miniwebtool.com/v1/tools/profit-calculator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"calc_mode":"margin_from_values","revenue":1000,"cost":600}'
```

copy

```text
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/profit-calculator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'calc_mode': 'margin_from_values', 'revenue': 1000, 'cost': 600},
)
resp.raise_for_status()
print(resp.json())
```

copy

```text
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/profit-calculator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"calc_mode":"margin_from_values","revenue":1000,"cost":600}),
  }
);
const data = await resp.json();
console.log(data);
```

copy

```text
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/profit-calculator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'calc_mode' => 'margin_from_values',
    'revenue' => 1000,
    'cost' => 600
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
```

copy

```text
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/profit-calculator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'calc_mode' => 'margin_from_values',
  'revenue' => 1000,
  'cost' => 600
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
```

copy

```text
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _:= json.Marshal(map[string]interface{}{
    "calc_mode": "margin_from_values",
    "revenue": 1000,
    "cost": 600,
  })
  req, _:= http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/profit-calculator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err:= http.DefaultClient.Do(req)
  if err!= nil { panic(err) }
  defer resp.Body.Close()
  out, _:= io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
```

copy

```text
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
.uri(URI.create("https://api.miniwebtool.com/v1/tools/profit-calculator/run"))
.header("Authorization", "Bearer mwt_live_YOUR_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"calc_mode\":\"margin_from_values\",\"revenue\":1000,\"cost\":600}"))
.build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
```

## How to call Profit Calculator

- 1 Get an API key
[Get an API key](/billing/checkout/?plan=starter). Choose the Starter plan or higher to receive a bearer token with access to this endpoint.
- 2 Assemble the JSON body
Required fields:. See the Request body table below for the full schema.
- 3 POST to`https://api.miniwebtool.com/v1/tools/profit-calculator/run`
Headers:`Authorization: Bearer <key>`and`Content-Type: application/json`. Copy-paste snippets in 7 languages are under Code examples.
- 4 Parse the response
Envelope:`{request_id, tool, tool_version, credits_used, result}`. The typed output lives in`result`.

## Frequently asked

What does the Profit Calculator API do? ▾
Solve profit, margin, markup, revenue, or cost from the known values. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.
How much does one call to Profit Calculator cost? ▾
2 credits per successful call. Failed calls (validation errors, 5xx) don't bill.
What parameters does the Profit Calculator API require? ▾
Required fields: (none). Full schema at /v1/openapi.json.
Is the Profit Calculator API deterministic? ▾
Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.
Can an AI agent call the Profit Calculator API? ▾
Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `profit-calculator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.
What format does the API return? ▾
JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.

## Use from an AI agent

Every endpoint on this site is also exposed via the [Model Context Protocol](/docs/#mcp) at`https://api.miniwebtool.com/v1/mcp`. Claude, Cursor, and any MCP-capable agent can discover this tool (`profit-calculator`) and its JSON Schema automatically — no client codegen.

```text
# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="profit-calculator")'
```

## Related finance tools

[
Doubling Time Calculator
Calculate exact doubling time, Rule of 72 estimates, or the rate required to do…
](/tools/doubling-time-calculator/) [
Markup Calculator
Calculate markup percentage, selling price, cost, profit, and margin.
](/tools/markup-calculator/) [
Discount Calculator
Calculate final price, savings, tax, stacked discounts, or BOGO deals.
](/tools/discount-calculator/) [
Simple Interest Calculator
Simple-interest formula: I = P * r * t.
](/tools/simple-interest-calculator/)
© 2026 miniwebtool. API is a separate product from the consumer site. [Terms](https://miniwebtool.com/about/terms-and-disclaimer/#api-terms) [Privacy](https://miniwebtool.com/about/privacy/#api-privacy) [consumer site →](https://miniwebtool.com)
