Skip to main content
POST
/
v1
/
propagate
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
}

ā€‹
Constraints

ConstraintLimit
Max window48 hours
Max points5,000
Default step60 seconds
Default window6 hours