Machine-readable API
Astrology Positions API
This page documents a simple JSON endpoint for calculating astrological planetary positions for one UTC moment. It is intended also for AI tools that cannot reliably calculate ephemerides on their own, but can use a precise calculator.
The endpoint returns clean JSON for one UTC moment: tropical ecliptic longitude, latitude, daily longitude speed, retrograde flag, zodiac sign, and optional houses.
Endpoint
GET /api/positions.php?dt=2026-05-17T12:00:00Z&bodies=So,Mo,Me,Ve,Ma,Ju,Sa,Ur,Ne,Pl,Nn,Ll&lon=14.417&lat=50.083&house=PParameters
| dt | ISO 8601 date and time. UTC is recommended, for example 2026-05-17T12:00:00Z. |
|---|---|
| bodies | Comma-separated body IDs, for example So,Mo,Me,Ve,Ma,Ju,Sa,Ur,Ne,Pl,Nn,Ll,Lt. The value all returns all supported bodies. |
| lon, lat | Optional geographic coordinates for house calculation. lon is longitude, lat is latitude. |
| house | Optional house system, for example P for Placidus. It is calculated only when both lon and lat are provided. |
Supported body codes
So Sun, Mo Moon, Me Mercury, Ve Venus, Ma Mars, Ju Jupiter, Sa Saturn, Ur Uranus, Ne Neptune, Pl Pluto, Nn mean North Node, Nt true Node, Ll mean Lilith, Lt true Lilith, Ch Chiron, Ph Pholus, Ce Ceres, Pa Pallas, Jo Juno, Va Vesta.
Machine-readable descriptions
OpenAPI schema llms.txt sitemap.xml
The endpoint is rate-limited and returns the header X-Robots-Tag: noindex so that individual query combinations are not indexed. The documentation should be indexed, not result URLs.