Home/API/Percentage Change

API Endpoint

Percentage Change

Calculate percentage change between two values.

Endpoint

POST https://likeoptions.com/api/v1/calculate/percentage

Also supports GET with query parameters.

Parameters

ParameterTypeDefaultDescription
originalnumber—Original value
newValuenumber—New value

Request Examples

POST (JSON body)
curl -X POST https://likeoptions.com/api/v1/calculate/percentage \ -H "Content-Type: application/json" \ -d '{"original": 100000, "newValue": 50000}'
GET (query parameters)
curl "https://likeoptions.com/api/v1/calculate/percentage?original=100000&newValue=50000"

Response

{ "kind": "percentage", "result": { "primary": 1234.56, "secondary": [ { "label": "Example metric", "value": 100, "format": "money" }, { "label": "Example percent", "value": 5.5, "format": "percent" } ] } }

When to Use

  • Calculate investment returns
  • Measure price changes
  • Compare year-over-year growth

Error Handling

  • 400 Bad Request — Invalid input parameters or missing required fields
  • 404 Not Found — Unknown calculator kind
  • 429 Too Many Requests — Rate limit exceeded (120 req/hour per IP)
  • 413 Payload Too Large — Request body exceeds 16 KB

Related Endpoints

View request examples in JavaScript, Python, cURL, and more →