get_spacetrack_gp_history
Retrieve historical orbital element sets from SpaceTrack for tracking satellite orbital evolution over time. Filter by NORAD ID, name, or epoch range, and decimate results to reduce data volume.
Instructions
Query historical GP records from SpaceTrack.
Unlike get_spacetrack_gp which returns only the latest element set, this tool returns all historical element sets for matching objects. Useful for tracking orbital evolution over time.
At least one filter parameter must be provided. An epoch_range is strongly recommended to avoid very large result sets. For queries spanning more than a couple of days, use the decimation parameter to thin results (e.g. '1d' for ~1 record per day).
Requires SPACETRACK_USER and SPACETRACK_PASS environment variables.
Args: norad_cat_id: NORAD catalog number (e.g. 25544 for ISS). name: Satellite name substring search (case-insensitive). epoch_range: ISO datetime range string "start--end" to filter by EPOCH (e.g. "2024-01-01--2024-01-31"). limit: Maximum number of records to return. decimation: Thin results to ~1 record per interval. Accepts a number followed by a unit: s (seconds), m (minutes), h (hours), d (days), w (weeks). Examples: "1d", "12h", "1w".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| limit | No | ||
| decimation | No | ||
| epoch_range | No | ||
| norad_cat_id | No |