Nearest stars
Your vessel will have the census feature, this allows you to figure out some details about the stars in your area. List the nearest stars. This is how you decide where to go next.
Endpoint
GET /v1/replicants/{code}/stars
Query parameters
| Name | Type | Description |
|---|---|---|
per_page | integer · optional | 1-50, default 10. |
page | integer · optional | Page number, default 1. |
Example
$ curl https://api.replicant.space/v1/replicants/8AFE4482/stars?per_page=3&page=1 \
-H "Authorization: Bearer $API_KEY"{
"page": 1,
"per_page": 3,
"replicant_position": {
"x": 34.1906,
"y": -8.9593,
"z": -42.9832
},
"stars": [
{
"designation": "CHAMAKUY",
"color": "red",
"distance_from_replicant": 0,
"estimated_planets": 4,
"estimated_travel_time": 0,
"position": { "x": 34.1906, "y": -8.9593, "z": -42.9832 }
},
{
"designation": "TARAZEDAR",
"color": "yellow",
"distance_from_replicant": 4.5,
"estimated_planets": 5,
"estimated_travel_time": 120,
"position": { "x": 37.8, "y": -7.1, "z": -41.0 }
},
{
"designation": "PORRAMA",
"color": "blue",
"distance_from_replicant": 6.8,
"estimated_planets": 3,
"estimated_travel_time": 182,
"position": { "x": 29.4, "y": -12.2, "z": -40.1 }
}
]
}Response fields
- replicant_position - your replicant's current galactic coordinate, used as the origin for distance calculations.
- distance_from_replicant - straight-line distance in light years.
- estimated_planets - approximate count from the long-range census. Only a full system scan confirms exact counts.
- estimated_travel_time - surge travel time in seconds from your replicant's current position.
- position - the star's galactic coordinate. See Locations for the coordinate model.