Propagate Trajectory - RotaStellar Docs

curl -X POST https://sim.rotastellar.com/v1/propagate \ -H "Content-Type: application/json" \ -d '{ "elements": { "altitude_km": 550, "inclination_deg": 53 }, "start": "2026-03-08T12:00:00Z", "end": "2026-03-08T14:00:00Z", "step_s": 60 }'

{ "trajectory": [ { "t": "2026-03-08T12:00:00Z", "lat": 42.15, "lon": -73.82, "altitude_km": 550.3, "velocity_km_s": 7.59, "in_eclipse": false, "orbit_fraction": 0.000 }, { "t": "2026-03-08T12:01:00Z", "lat": 42.58, "lon": -72.14, "altitude_km": 550.3, "velocity_km_s": 7.59, "in_eclipse": false, "orbit_fraction": 0.010 } ], "count": 121, "start": "2026-03-08T12:00:00Z", "end": "2026-03-08T14:00:00Z", "step_s": 60 }

Base URL: https://sim.rotastellar.com — No API key required.

Request

elements

object

required

Orbital elements. See Orbital Elements.

start

string

ISO 8601 start time. Defaults to current time.

end

string

ISO 8601 end time. Default: start + 6 hours. Max window: 48 hours.

step_s

number

Seconds between trajectory points. Default: 60. Max 5,000 total points.

curl -X POST https://sim.rotastellar.com/v1/propagate \
  -H "Content-Type: application/json" \
  -d '{
    "elements": {
      "altitude_km": 550,
      "inclination_deg": 53
    },
    "start": "2026-03-08T12:00:00Z",
    "end": "2026-03-08T14:00:00Z",
    "step_s": 60
  }'

{
  "trajectory": [
    {
      "t": "2026-03-08T12:00:00Z",
      "lat": 42.15,
      "lon": -73.82,
      "altitude_km": 550.3,
      "velocity_km_s": 7.59,
      "in_eclipse": false,
      "orbit_fraction": 0.000
    },
    {
      "t": "2026-03-08T12:01:00Z",
      "lat": 42.58,
      "lon": -72.14,
      "altitude_km": 550.3,
      "velocity_km_s": 7.59,
      "in_eclipse": false,
      "orbit_fraction": 0.010
    }
  ],
  "count": 121,
  "start": "2026-03-08T12:00:00Z",
  "end": "2026-03-08T14:00:00Z",
  "step_s": 60
}

Constraint	Limit
Max window	48 hours
Max points	5,000
Default step	60 seconds
Default window	6 hours

Constraint

Limit

Max window

48 hours

Max points

5,000

Default step

60 seconds

Default window

6 hours

​Request

​Constraints

Request

Constraints