ForHosting KIT · Developer Utilities

Central mass from moon orbit calculator

This central mass from moon orbit calculator estimates the mass of a planet or other central body from an orbiting moon's period and semi-major axis.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

Enter the period in seconds and the center-to-center semi-major axis in metres. The calculator applies the Newtonian form of Kepler's third law and returns the estimated central mass in kilograms. It provides a quick, reproducible result for astronomy study, observation checks, simplified simulations, and comparisons among satellite systems without requiring a spreadsheet or an external astronomical database.

Prepare the orbital measurements in SI units

Begin with the moon's orbital period: the elapsed time required for one complete revolution around the central body. Enter that duration in seconds. If a source gives days, multiply by 86,400; if it gives hours, multiply by 3,600. The period must be greater than zero because a zero or negative duration cannot describe an orbit and would make the equation undefined. Next, provide the semi-major axis in metres. This is half the longest diameter of the orbital ellipse and is measured from the center of the central body to the center of the moon, not from the central body's surface. For a nearly circular orbit, it is effectively the mean orbital radius. Convert kilometres to metres by multiplying by one thousand. Keep more meaningful digits during conversion than you intend to show in the final answer, since premature rounding is amplified when the semi-major axis is cubed. Both inputs must be finite numbers, and the semi-major axis must also be positive. Record the source and epoch of each measurement when reproducibility matters, because published orbital elements can use different reference solutions.

Understand the Kepler calculation

The calculator evaluates M = 4π²a³/(GT²), where M is central mass, a is the moon's semi-major axis, T is its orbital period, and G is the gravitational constant. It uses G = 6.67430 × 10^-11 cubic metres per kilogram per second squared, so SI inputs produce kilograms directly. This is the Newtonian form of Kepler's third law under the common approximation that the moon's mass is negligible compared with the body it orbits. The calculation is deterministic and performs no lookup: identical numeric inputs always return the same value. The relationship also explains input sensitivity. A one-percent change in semi-major axis produces roughly a three-percent change in estimated mass, while a one-percent change in period produces roughly a two-percent change in the opposite direction. Accurate distance data is therefore especially important. The returned value is not forced to a fixed number of decimal places. Round it to a precision justified by the least certain orbital measurement rather than treating every displayed digit as physically significant.

Interpret the result and know the approximation

Read the output as an estimate of the central body's mass in kilograms derived solely from the supplied orbit. It is useful for checking textbook work, comparing a computed value with a published planetary mass, or establishing a first-order parameter for a simulation. The result assumes an ideal two-body system governed by Newtonian gravity. If the moon has a non-negligible mass, the equation actually recovers the sum of the two bodies' masses; subtract the moon's independently known mass when that distinction matters. Comparable-mass binary systems should be handled explicitly as two-body systems rather than described as a small moon around a fixed center. Perturbations from other satellites, a star, resonances, an irregular gravity field, tides, and relativistic effects are not modeled. Also ensure that the period and semi-major axis describe the same orbit and reference frame. A sidereal orbital period is normally appropriate; mixing it with a synodic period can produce a misleading estimate. For confidence, compare the output against an accepted mass and investigate discrepancies in units, center-to-center distance, period definition, or the negligible-moon-mass assumption before concluding that the formula is wrong.

Check an astronomy exercise

Verify a central-mass calculation from a moon's measured period and semi-major axis.

Estimate an observed body's mass

Turn basic orbital observations of a satellite into a first-order mass estimate in kilograms.

Validate simulation parameters

Compare a simulation's central mass with the value implied by its moon's configured orbit.

What formula does the calculator use?

It uses M = 4π²a³/(GT²), the Newtonian form of Kepler's third law, with SI units.

Which orbital period should I enter?

Use the time for one complete orbit in seconds, normally the sidereal period. It must be greater than zero.

Is the semi-major axis measured from the surface?

No. It is measured center to center and must be entered in metres. For a circular orbit, it equals the orbital radius.

Does the moon's mass affect the answer?

The exact two-body relationship yields the combined mass. This calculator labels the result as central mass under the usual assumption that the moon is much less massive.

How much does an API calculation cost?

Each API request costs $0.002. The analytic calculation is deterministic and uses no external network service.

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.

POSThttps://api.kit.forhosting.com/astro/central-mass-from-moon

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.

curl -X POST https://api.kit.forhosting.com/astro/central-mass-from-moon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orbital_period_s":2360591.5,"semi_major_axis_m":384400000}'
{
  "orbital_period_s": 2360591.5,
  "semi_major_axis_m": 384400000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.central_mass_from_moon",
  "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.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →