Orion Telemetry API

API v2.4 Last updated: 2 hours ago • 5 min read

The Orion Telemetry API provides real-time access to satellite health data, orbital parameters, propulsion metrics, and payload status for all AeroVance-managed space assets. This RESTful API supports JSON requests and WebSocket streaming for high-frequency telemetry.

ℹ️

Base URL: All API requests should be made to https://api.aerovance.io/v2. Sandbox environments use https://sandbox.api.aerovance.io/v2.

Authentication

All API requests require authentication via Bearer token in the Authorization header. Tokens are generated using your API Key and must be rotated every 90 days in compliance with ITAR security protocols.

HTTP

GET /v2/satellites/orion-7/telemetry
Host: api.aerovance.io
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
X-Client-ID: client_prod_8x9k2m

⚠️

Security Notice: Never expose API keys in client-side code. All tokens must be generated server-side. Violations may result in immediate account suspension and legal review under ITAR regulations.

Core Endpoints

The following endpoints provide access to real-time telemetry data streams. All responses return JSON payloads.

Method	Endpoint	Description	Rate Limit
GET	/v2/satellites/{id}/telemetry	Retrieve latest telemetry snapshot	60 req/min
GET	/v2/satellites/{id}/orbit	Current orbital parameters (TLE data)	30 req/min
POST	/v2/satellites/{id}/command	Submit command sequence	10 req/min
POST	/v2/satellites/{id}/propulsion/fire	Initiate engine burn (Requires Level 5 Clearance)	5 req/hour

Response Format

Telemetry responses include structured data for all subsystems. Below is a sample response for an active LEO satellite.

JSON

{
  "status": "nominal",
  "satellite_id": "orion-7",
  "timestamp": "2025-01-15T14:32:00Z",
  "telemetry": {
    "propulsion": {
      "fuel_level": 87.4,
      "thrust_capacity": "100%",
      "engine_temp": 342,
      "units": "Celsius"
    },
    "attitude": {
      "pitch": 0.02,
      "yaw": -0.01,
      "roll": 0.00,
      "gyro_health": "healthy"
    },
    "power": {
      "solar_arrays": 4.2,
      "battery_charge": 92,
      "load": 3.1,
      "units": "kW"
    }
  },
  "orbit": {
    "altitude": 550,
    "inclination": 97.4,
    "velocity": 7.6,
    "units": "km/s"
  }
}

Using the Python SDK

AeroVance provides official SDKs for Python, Node.js, and Go. Install via pip:

BASH

pip install aerovance-sdk

Example usage to retrieve propulsion data:

Python

import aerovance

# Initialize client with API key
client = aerovance.Client(api_key="YOUR_API_KEY")

# Fetch propulsion telemetry
telemetry = client.satellites.get_telemetry(
    satellite_id="orion-7",
    subsystem="propulsion"
)

print(f"Fuel Level: {telemetry.fuel_level}%")
# Output: Fuel Level: 87.4%

🚫

Propulsion Commands: Any endpoint that modifies propulsion states requires Level 5 Security Clearance and multi-factor authentication. Unauthorized attempts are logged and reported to security immediately.

Error Codes

The API uses standard HTTP status codes. Common errors include:

401 Unauthorized - Invalid or expired API token
403 Forbidden - Insufficient clearance level for requested action
429 Too Many Requests - Rate limit exceeded
503 Service Unavailable - Ground station communication window closed

For real-time error monitoring, connect to the WebSocket endpoint at wss://api.aerovance.io/v2/stream.

Was this page helpful?