> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rotastellar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Orbital Intelligence Overview

> Track, analyze, and understand objects in Earth orbit

# Orbital Intelligence

<Info>
  **Status:** Early Access — [Request API key](https://rotastellar.com/developers)
</Info>

Orbital Intelligence provides real-time situational awareness for objects in Earth orbit. Track satellites, analyze conjunction risks, and detect anomalous behavior.

## Capabilities

<CardGroup cols={2}>
  <Card title="Satellite Tracking" icon="satellite" href="/intelligence/satellites">
    Real-time positions for 10,000+ active satellites
  </Card>

  <Card title="Conjunction Analysis" icon="triangle-exclamation" href="/intelligence/conjunctions">
    Collision probability and avoidance recommendations
  </Card>

  <Card title="Pattern Detection" icon="chart-line" href="/intelligence/patterns">
    Detect anomalies and maneuvers in satellite behavior
  </Card>

  <Card title="Webhooks" icon="bell" href="/intelligence/webhooks">
    Real-time alerts for events of interest
  </Card>
</CardGroup>

## Quick Start

<CodeGroup>
  ```python Python theme={null}
  from rotastellar import RotaStellarClient

  client = RotaStellarClient(api_key="rs_...")

  # Track the International Space Station
  iss = client.get_satellite("25544")  # ISS NORAD ID

  print(f"Location: {iss.position.latitude}, {iss.position.longitude}")
  print(f"Altitude: {iss.position.altitude_km} km")

  # Check for upcoming conjunctions
  conjunctions = client.list_conjunctions(
      satellite_id="25544",
      threshold_km=5.0,
      limit=10
  )

  for conj in conjunctions:
      print(f"TCA: {conj['tca']}")
      print(f"Miss distance: {conj['miss_distance_km']} km")
      print(f"Probability: {conj['collision_probability']}")
  ```

  ```typescript Node.js theme={null}
  import { RotaStellarClient } from '@rotastellar/sdk';

  const client = new RotaStellarClient({ apiKey: 'rs_...' });

  // Track ISS
  const iss = await client.getSatellite('25544');

  console.log(`Location: ${iss.position?.latitude}, ${iss.position?.longitude}`);
  console.log(`Altitude: ${iss.position?.altitudeKm} km`);

  // Check conjunctions
  const conjunctions = await client.listConjunctions({
    satelliteId: '25544',
    thresholdKm: 5.0,
    limit: 10
  });

  for (const conj of conjunctions) {
    console.log(`TCA: ${conj.tca}, Miss: ${conj.miss_distance_km} km`);
  }
  ```

  ```bash cURL theme={null}
  # Get ISS position
  curl https://api.rotastellar.com/v1/satellites/ISS \
    -H "Authorization: Bearer rs_your_api_key"

  # Check conjunctions
  curl "https://api.rotastellar.com/v1/conjunctions?satellite=ISS&threshold_km=5&days_ahead=7" \
    -H "Authorization: Bearer rs_your_api_key"
  ```
</CodeGroup>

## Data Sources

| Source      | Coverage          | Update Frequency |
| ----------- | ----------------- | ---------------- |
| Space-Track | Global catalog    | Every 8 hours    |
| Commercial  | Active satellites | Real-time        |
| Proprietary | Enhanced accuracy | Continuous       |

## Catalog Coverage

* **10,000+** active satellites
* **35,000+** debris objects tracked
* **45,000+** total tracked objects
* **Global** coverage from multiple sensor networks

## Use Cases

### Fleet Management

Track your entire satellite constellation and monitor health:

```python theme={null}
# Get all satellites in your constellation
constellation = client.list_satellites(
    operator="YourCompany",
    constellation="YourConstellation"
)

for sat in constellation:
    print(f"{sat.name}: {sat.position.altitude_km}km")
```

### Collision Avoidance

Get alerts when conjunction risks exceed thresholds:

```python theme={null}
# Set up conjunction monitoring via webhook
# See /intelligence/webhooks for full setup
import requests

requests.post(
    "https://api.rotastellar.com/v1/conjunctions/watch",
    headers={"Authorization": "Bearer rs_your_api_key"},
    json={
        "satellites": ["SAT-001", "SAT-002", "SAT-003"],
        "threshold_km": 1.0,
        "webhook_url": "https://your-app.com/alerts"
    }
)
```

### Anomaly Detection

Detect unexpected maneuvers or behavior changes:

```python theme={null}
anomalies = client.list_patterns(
    satellite_id="TARGET-SAT",
    type="anomaly",
    lookback_days=30
)

for anomaly in anomalies:
    print(f"{anomaly['timestamp']}: {anomaly['type']}")
    print(f"Description: {anomaly['description']}")
```

## Rate Limits

| Endpoint        | Free   | Pro     | Enterprise |
| --------------- | ------ | ------- | ---------- |
| Get Satellite   | 10/min | 100/min | Custom     |
| List Satellites | 5/min  | 50/min  | Custom     |
| Conjunctions    | 5/min  | 50/min  | Custom     |
| Patterns        | 2/min  | 20/min  | Custom     |

## Next Steps

<CardGroup cols={2}>
  <Card title="Satellite Tracking" icon="satellite" href="/intelligence/satellites">
    Deep dive into satellite tracking API
  </Card>

  <Card title="Conjunction Analysis" icon="triangle-exclamation" href="/intelligence/conjunctions">
    Learn about collision risk assessment
  </Card>
</CardGroup>