Synodic period API

Returns the synodic period 1/S=|1/T1-1/T2| — how often two orbiting bodies realign (e.g. Earth-Mars launch windows) — in seconds/days/years. Answers 'How often do Earth and Mars line up?', 'Synodic period of two satellites?'.

Price$0.04per request

MethodPOST

Route/v1/space/synodic-period

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

spaceastronomysynodic-periodconjunctionlaunch-windoworbital-mechanicsalignmentastrodynamics

API URLhttps://x402.hexl.dev/v1/space/synodic-period

Integration docs

Example request

{
  "period1S": 31557600,
  "period2S": 59354000
}

Example response

{
  "period1S": 31557600,
  "period2S": 59354000,
  "synodicPeriodS": 67385337.3243,
  "synodicPeriodDays": 779.922886,
  "synodicPeriodYears": 2.13531249,
  "interpretation": "The two bodies realign every 779.92 days."
}

Input schema

{
  "type": "object",
  "required": [
    "period1S",
    "period2S"
  ],
  "properties": {
    "period1S": {
      "type": "number",
      "examples": [
        31557600
      ]
    },
    "period2S": {
      "type": "number",
      "examples": [
        59354000
      ]
    }
  }
}

Output schema

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