{"uid":"cap_G61PQluBOmcHMypr7RDlY","slug":"physics-calculators-orbital-mechanics-176d9d62","name":"Physics Calculators: Orbital Mechanics","description":"Circular orbit speed, escape speed and period at an altitude or radius around the Sun, a planet, the Moon or a custom mass.","url":"https://physics-calc.x402tookit.com/orbit?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"body":{"type":"string","description":"sun, mercury, venus, earth (default), moon, mars, jupiter, saturn, uranus or neptune"},"altitudeKm":{"type":"number","description":"Height above the body's mean radius in km (default 0 = surface)"},"muKm3PerS2":{"type":"number","description":"Custom standard gravitational parameter GM in km3/s2 (replaces body; needs orbitRadiusKm)"},"orbitRadiusKm":{"type":"number","description":"Or the distance from the body's centre in km (instead of altitude)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"body":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"altitudeKm":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"muKm3PerS2":{"type":["null","number"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"periodDays":{"type":["null","number"]},"speedInKmH":{"type":["null","number"]},"periodHours":{"type":["null","number"]},"orbitRadiusKm":{"type":["null","number"]},"periodMinutes":{"type":["null","number"]},"periodSeconds":{"type":["null","number"]},"escapeSpeedKmS":{"type":["null","number"]},"bodyMeanRadiusKm":{"type":["null","number"]},"circularSpeedKmS":{"type":["null","number"]},"gravityAtOrbitMS2":{"type":["null","number"]},"surfaceGravityMS2":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NndLBQNmja8WXYeIz6GaZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates circular orbit speed, escape speed, and orbital period at a given altitude or radius around the Sun, planets, the Moon, or a custom mass.","exampleAgentPrompt":"What's the circular orbit speed, escape velocity, and orbital period for a satellite 400 km above Earth's surface?","exampleUseCases":[{"title":"ISS low Earth orbit check","prompt":"Calculate the orbital speed and period for a satellite orbiting Earth at 408 km altitude — that's roughly the ISS height."},{"title":"Mars mission orbit planning","prompt":"What circular orbit speed and orbital period would a spacecraft have at 300 km above Mars, and what's the escape velocity from that altitude?"},{"title":"Custom body orbital calculation","prompt":"I have a custom body with GM of 4902.8 km³/s² and I want to know the circular speed and escape speed at an orbit radius of 1838 km from its center."}],"resultDescription":"Returns circular orbit speed (km/s), escape speed (km/s), orbital period (in seconds, minutes, hours, and days), orbit radius (km), altitude (km), gravitational acceleration at the orbit, surface gravity, body mean radius, and GM — plus metadata like body name, data source, and any disclaimers.","failureModes":["Missing required 'body' or 'muKm3PerS2' parameter returns an error or defaults to Earth","Providing an altitude below zero (underground) may return an error or unexpected result","Custom GM without orbitRadiusKm may fail validation","Unsupported body name (e.g. 'pluto') may return an error or null result","Network or payment failure returns a 402 or 5xx HTTP error"],"whenToPreferThis":"Use this endpoint when you need precise orbital mechanics calculations (speed, period, escape velocity) for any solar system body or a custom mass, without writing physics formulas yourself. Prefer this over a general physics LLM response when you need accurate numeric results grounded in standard GM values for named bodies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:13:40.464Z","isFirstParty":false,"canonicalSlug":"physics-calculators-orbital-mechanics-176d9d62"}