Ir al contenido
GET /v1/positions

Body positions (equatorial + horizontal)

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/astronomy-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/astronomy-api/v1/positions" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/astronomy-api/v1/positions", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/astronomy-api/v1/positions");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/astronomy-api/v1/positions",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "count": 3,
        "bodies": [
            {
                "body": "sun",
                "azimuth_deg": 356.3333,
                "distance_au": 1.01373323,
                "altitude_deg": -14.9883,
                "above_horizon": false,
                "declination_deg": 21.87658,
                "right_ascension_hours": 4.52418
            },
            {
                "body": "moon",
                "azimuth_deg": 181.8299,
                "distance_au": 0.00270462,
                "altitude_deg": 10.6284,
                "above_horizon": true,
                "declination_deg": -26.91787,
                "phase_angle_deg": 6.72,
                "apparent_magnitude": -12.39,
                "illuminated_fraction": 0.9966,
                "right_ascension_hours": 16.13585
            },
            {
                "body": "mars",
                "azimuth_deg": 28.1474,
                "distance_au": 2.18651356,
                "altitude_deg": -19.0418,
                "above_horizon": false,
                "declination_deg": 13.88561,
                "phase_angle_deg": 21.42,
                "apparent_magnitude": 1.27,
                "illuminated_fraction": 0.9655,
                "right_ascension_hours": 2.45351
            }
        ],
        "datetime": "2026-05-30T22:48:45.523Z",
        "observer": {
            "latitude": 52.52,
            "longitude": 13.405,
            "elevation_m": 0
        }
    },
    "meta": {
        "timestamp": "2026-05-30T22:48:45.524Z",
        "request_id": "fa34225e-05e0-4a7b-be88-931848531fa4"
    },
    "status": "ok",
    "message": "OK",
    "success": true
}