> ## 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.

# Quickstart

> Get up and running in 5 minutes

# Quickstart

This guide will get you from zero to your first API call in under 5 minutes.

## 1. Get an API Key

<Card title="Request API Key" icon="rocket" href="https://rotastellar.com/developers">
  Sign up to receive your API credentials.
</Card>

## 2. Install the SDK

<CodeGroup>
  ```bash Python theme={null}
  pip install rotastellar
  ```

  ```bash Node.js theme={null}
  npm install @rotastellar/sdk
  ```

  ```bash Rust theme={null}
  cargo add rotastellar
  ```
</CodeGroup>

## 3. Make Your First Request

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

  client = RotaStellarClient(api_key="rs_your_api_key")

  # Get ISS position
  iss = client.get_satellite("25544")  # ISS NORAD ID

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

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

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

  // Get ISS position
  const iss = await client.getSatellite('25544');  // ISS NORAD ID

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

  ```rust Rust theme={null}
  use rotastellar::types::{Position, Orbit};

  fn main() -> Result<(), Box<dyn std::error::Error>> {
      // Rust SDK provides types only (HTTP client coming soon)
      // Use Python or Node.js SDK for full API access

      // Create a position type for ISS-like coordinates
      let pos = Position::new(41.264, -95.123, 420.5)?;

      println!("Location: {}, {}", pos.latitude, pos.longitude);
      println!("Altitude: {} km", pos.altitude_km);

      Ok(())
  }
  ```

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

## 4. Explore the API

Now that you're set up, explore what you can build:

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

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

  <Card title="Plan Orbital Compute" icon="calculator" href="/planning/feasibility">
    Feasibility analysis for space-based workloads
  </Card>

  <Card title="Simulate Thermals" icon="temperature-high" href="/planning/thermal">
    Heat rejection modeling for orbital hardware
  </Card>
</CardGroup>

## Rate Limits

| Tier       | Requests/minute | Requests/day |
| ---------- | --------------- | ------------ |
| Free       | 10              | 1,000        |
| Pro        | 100             | 100,000      |
| Enterprise | Custom          | Custom       |

## Need Help?

* [API Reference](/api-reference) — Full endpoint documentation
* [GitHub Issues](https://github.com/rotastellar/rotastellar-python/issues) — Bug reports and feature requests
* [Contact Us](https://rotastellar.com/contact/) — Enterprise support
