Specific orbital energy API

Returns the specific orbital energy epsilon=-mu/(2a) (or from r and v) and classifies the orbit as elliptical/parabolic/hyperbolic. Answers 'Is this orbit bound?', 'What is the specific energy of this trajectory?'.

Price$0.04per request

MethodPOST

Route/v1/space/specific-orbital-energy

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

spaceastronomyorbital-energyspecific-energyorbital-mechanicsbound-orbithyperbolicastrodynamics

API URLhttps://x402.hexl.dev/v1/space/specific-orbital-energy

Integration docs

Example request

{
  "body": "earth",
  "semiMajorAxisM": 6771000
}

Example response

{
  "body": "earth",
  "mu": 398600441800000,
  "semiMajorAxisM": 6771000,
  "specificEnergyJPerKg": -29434385.0096,
  "orbitType": "elliptical (bound)",
  "interpretation": "Specific orbital energy -29434385 J/kg => elliptical (bound)."
}

Input schema

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "examples": [
        "earth"
      ]
    },
    "mu": {
      "type": "number"
    },
    "centralMassKg": {
      "type": "number"
    },
    "semiMajorAxisM": {
      "type": "number",
      "examples": [
        6771000
      ]
    },
    "radiusM": {
      "type": "number"
    },
    "velocityMs": {
      "type": "number"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}