Our ephemeris database has a query engine that will return information from it. Here's how to use it. The interface is:


The query arguments are:

The date is a date in ISO standard format. This is a string of the form yyyy-mm-mm[Thh:mm:ss[+/-hh:mm]]. In this string, the separators '-' and ':' are optional, as are the parts in [brackets]. The parts of this string are:

If you provide a time, the required character T introduces it. Time is in 24-hour clock format:

Times are interpreted as Coordinated Universal Time (UTC) unless you also provide a time zone offset. This is a string of the form +/-hh:mm, in which:

If you don't provide a time zone offset, the time is assumed to be UTC/GMT. If you don't provide a time at all, we use midnight UTC (00:00:00).

So, for example, if you wanted to see an ephemeris for Jan 2, 2012, at midnight PST, you could use d=2012-01-02T00:00-08:00. Again, '-' and ':' are optional but 'T' is required.

Important: If you provide an invalid time string, the system uses "now". If even one part of the date or time is invalid, the whole string is invalid.

The planet-list is a list of planets you want information for. If there is more than one name in the list, separate them with '+'. We recognize these planet names:

Values are returned as plain text in 'comma-separated value' (CSV) format. Except for the first line, each line has the form:


The first line is a status report. '200' is an 'OK' status. If that line is not '200', there was a problem with the request. Otherwise, the following lines contain information about the planets you asked for:

The numbers enclosed in "quotes" have the form ddd:mm:ss.cc, where DDD=degrees, MM=minutes, and SS.CC=seconds and centiseconds. We don't vouch for complete accuracy in the seconds and centiseconds, but our source (Swiss Ephemeris) claims their database is at least as accurate as traditional astrological databases.

Please note: this application contains code provided by Swiss Ephemeris. As such, it is licensed under the GNU GPL. Our modified source is available for download as a gzip'ed tar archive. We made it work on Mac OS X, then revised it to compile on CentOS. We have no idea if it will work anywhere else. You're welcome to adapt this source for your own use according to the terms of the GNU GPL. However, before you will be able to do anything useful with the source code, you'll also need to obtain some Swiss Ephemeris versions of NASA JPL ephemerides files. They're available from Swiss Ephemeris:

In Oakland CA, it is
Tue, 18 Jun 2024 9:17 PM.
Register     Forgot user name/password