API Reference

/positions Endpoint

Retrieve real-time satellite positions with ECEF coordinates, geodetic data, and epoch information.

Base URL

https://api.cryptik.tech

Authentication

All requests require an API key passed via the X-API-Key header.

curl -H "X-API-Key: your-api-key" \
  https://api.cryptik.tech/positions

GET/positions

Returns an array of satellite positions with current coordinates.

Query Parameters

Parameter	Type	Description
`limit`	integer	Max satellites to return (optional)

Response

{
  "timestamp": "2024-02-04T00:30:00Z",
  "satellites": [
    {
      "norad_id": 25544,
      "name": "ISS (ZARYA)",
      "x": 4234.567,
      "y": -1234.890,
      "z": 5123.456,
      "lat": 48.234,
      "lon": -122.456,
      "alt": 420.5,
      "epoch": "2024-02-04T00:28:00Z",
      "risk": "nominal"
    }
  ]
}

Response Fields

norad_idintegerNORAD Catalog ID

namestringSatellite name

x, y, zfloatECEF coordinates (km)

latfloatGeodetic latitude (degrees)

lonfloatGeodetic longitude (degrees)

altfloatAltitude above WGS-84 ellipsoid (km)

epochstringTLE epoch timestamp (ISO 8601)

riskstringRisk assessment status

Use Cases

Real-time Tracking Dashboard

Display live satellite positions on a 3D globe or 2D map with automatic updates.

Collision Detection

Monitor satellite trajectories and calculate potential conjunction events.

Ground Station Scheduling

Determine optimal pass times for satellite communication windows.

Space Debris Analysis

Track and visualize orbital debris for mission planning and risk assessment.

Rate Limits

Standard API Key

60 requests / minute

Data Refresh

Every 6 hours