Skip to main content
POST
/
v1
/
state
curl -X POST https://sim.rotastellar.com/v1/state \
  -H "Content-Type: application/json" \
  -d '{
    "elements": {
      "altitude_km": 550,
      "inclination_deg": 53,
      "eccentricity": 0.0001,
      "raan_deg": 0,
      "mean_anomaly_deg": 0,
      "epoch": "2026-03-08T00:00:00Z"
    },
    "timestamp": "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.234,
  "timestamp": "2026-03-08T12:00:00Z"
}
Base URL: https://sim.rotastellar.com — No API key required.

​
Request

​
elements
object
required
Orbital elements defining the satellite orbit. Must include either altitude_km or mean_motion, plus inclination_deg. See Orbital Elements for full schema.
​
timestamp
string
ISO 8601 timestamp for computation. Defaults to current time.
curl -X POST https://sim.rotastellar.com/v1/state \
  -H "Content-Type: application/json" \
  -d '{
    "elements": {
      "altitude_km": 550,
      "inclination_deg": 53,
      "eccentricity": 0.0001,
      "raan_deg": 0,
      "mean_anomaly_deg": 0,
      "epoch": "2026-03-08T00:00:00Z"
    },
    "timestamp": "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.234,
  "timestamp": "2026-03-08T12:00:00Z"
}

​
Response Fields

FieldTypeDescription
latnumberGeodetic latitude (degrees)
lonnumberGeodetic longitude (degrees)
altitude_kmnumberHeight above WGS-84 ellipsoid
velocity_km_snumberOrbital velocity
in_eclipsebooleanWhether satellite is in Earth’s shadow
orbit_fractionnumberPosition in orbit (0–1)
timestampstringISO 8601 computation timestamp