Gas calculator
A 400-mile trip in a car that averages 25 miles per gallon needs 16 gallons, which at 3.2 per gallon costs 51.2. Enter distance, fuel efficiency and the price of one gallon or litre to get fuel and cost. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Distance
- 400
- Efficiency
- 25
- Fuel price
- 3.2
- Fuel volume
- 16
- Total cost
- 51.2
A family road trip, a weekend visit, or a long commute usually starts with the same kitchen-table question: how much gas will the car need, and what will that fuel cost at today's pump price. This gas calculator takes three everyday numbers — trip distance, the vehicle's fuel efficiency written as distance per unit of fuel, and the price of one unit of gas — and returns fuel volume plus total cost. Volume is distance divided by efficiency; cost is that volume times the unit price. The identity is unit-agnostic, so miles with miles per gallon and kilometres with kilometres per litre both work when the three inputs share one coherent system.
How the gas calculator turns three numbers into volume and cost
Fuel volume for a journey equals trip distance divided by vehicle fuel efficiency when efficiency is written as distance per unit of fuel — miles per gallon, kilometres per litre, or any other coherent pair. A four-hundred-mile drive in a car that averages twenty-five miles per gallon needs sixteen gallons; at three dollars and twenty cents per gallon the total cost is fifty-one dollars and twenty cents. The same school identity works in metric: one hundred eighty kilometres at twelve kilometres per litre needs fifteen litres, times the litre price.
This landing stays on that pair of results. Keep units coherent — do not mix miles with kilometres per litre without converting first. Brochure stickers and dashboard computers are useful in other moments, but the everyday search for a gas calculator is usually this three-number identity and nothing more.
Where a household gas calculator belongs in daily life and software
Private drivers meet this calculation when a map distance, a handbook efficiency figure, and a pump screenshot are enough to decide whether a weekend visit fits the month's fuel budget. Households use it to compare two cars on the same route at the same posted price without opening a fleet telematics stack. Students and driving instructors use it to connect the textbook idea of fuel needed with a concrete volume and a concrete cost, including the classic four-hundred miles at twenty-five miles per gallon example that yields sixteen gallons.
Expense and mileage products call the contract from scripts when a user logs a planned distance and a rated efficiency and the app must show volume and money without shipping a routing engine. Keep requests inside the published magnitude ceiling, pin the six-decimal volume and cost in tests, and you get a reproducible gas figure for family budgets, LMS plugins, and edge workers without standing up a vehicle-dynamics model of your own.
What you can do with it
Family road-trip fuel budget
Enter planned miles or kilometres, the car's average mpg or km/L, and the local pump price to see fuel volume and total cost before booking hotels.
FAQ
How does the gas calculator compute fuel volume and cost?
Fuel volume is distance / efficiency. Total cost is that volume times the unit price.
What happens if distance or efficiency is zero or negative?
A non-positive trip length or vehicle efficiency does not define a fuel fill, so the calculator will not invent infinity or a silent NaN.
Which units should I enter?
Use one coherent system: miles with miles per gallon and a per-gallon price, or kilometres with kilometres per litre and a per-litre price. This landing does not convert mixed units for you.
Can the fuel price be zero?
Yes, when distance and efficiency are positive. Zero unit price over a measured stretch is a total cost of zero. A negative pump price is rejected.
What does the gas calculator cost?
It is free in your browser on this page.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/life/gas \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"distance":400,"efficiency":25,"fuel_price":3.2}'const res = await fetch("https://api.kit.forhosting.com/life/gas", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"distance": 400,
"efficiency": 25,
"fuel_price": 3.2
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/gas",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"distance": 400,
"efficiency": 25,
"fuel_price": 3.2
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/gas", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"distance":400,"efficiency":25,"fuel_price":3.2}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"distance":400,"efficiency":25,"fuel_price":3.2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/gas", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"distance": 400,
"efficiency": 25,
"fuel_price": 3.2
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.gas",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Limits
max_abs | 1000000000 |
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
Distance and efficiency must be positive finite numbers; a zero or negative value is rejected as invalid_input instead of inventing a free tank or dividing by zero.
How the gas calculator turns three numbers into volume and cost
You send required fields distance, efficiency, and fuel_price as JSON numbers or numeric strings. Aliases miles, km, trip_distance, and d map to distance; fuel_efficiency, mpg, economy, km_per_l, and fuel_economy map to efficiency; price, gas_price, price_per_unit, and fuel_unit_price map to the unit price. The response echoes the three inputs after stable six-decimal rounding, plus fuel_volume, total_cost, a method tag, and a formula string you can print next to a budget line. There is no traffic model, no live map feed, and no date-dependent shortcut: the engine either builds two finite non-negative figures inside the supported numeric range or rejects the input with invalid_input. That honesty is the point of a household gas calculator.
Input contract, units, and the required positive-number checks
Optional leading plus signs and scientific notation on numeric strings are allowed when they parse as finite decimals; embedded spaces, hex prefixes, and non-numeric tokens are rejected with a message that names the field, so a bad cell does not become a wrong tank fill. After validation the engine applies the school identity: fuel volume equals distance divided by efficiency, and total cost equals that volume times the unit price. Distance and efficiency must be strictly positive. Fuel price may be zero when the distance and efficiency are positive: complimentary fuel over a measured stretch reports a total cost of zero, which is a legitimate budget line. A negative pump price is rejected. The preferred fields are distance for the length of the trip, efficiency for the vehicle's distance-per-unit rating, and fuel_price for the pump price of one unit of fuel, but the documented aliases are accepted so spreadsheets, query strings, and typed forms can reuse the same contract without renaming columns. A zero or negative trip length does not define a fuel fill, and a zero or negative efficiency would divide by zero or invent a nonsense credit, so both cases fail with invalid_input. That is the specified error path. Magnitude caps keep results finite on the Worker isolate. Pair the free browser run on this page with the priced API when you need the identical mathematical result inside an automated pipeline.
Where a household gas calculator belongs in daily life and software
Product and education tools use the two-number response when the audience already works in one coherent unit system and does not need a converter on the same payload. On this page the work runs entirely in your browser; through the API each successful lookup costs $0.002, failed validation is not charged, and nothing is stored after the response returns. That split — free interactive exploration and a priced, identical API — matches the rest of the tier-A catalog and lets you move from a kitchen-table demo to an automated pipeline without changing the mathematical result. This endpoint does not add tolls, lodging, or food, and it does not split the bill among passengers; it answers the gas line only.
Integration use cases
Homework and driving-school checks
Confirm the textbook identity volume = distance / efficiency and cost = volume × price, including the required invalid_input when distance or efficiency is not positive.
Deterministic fixtures for expense apps
Generate reproducible fuel_volume and total_cost fields for household budget tools, CI assertions, and simple mileage dashboards.