Delta T and time scales API
Give a moment; get it in every astronomical time scale: Julian day in UTC, UT1, TT and TDB, modified Julian day, Julian centuries since J2000, Delta T, UT1-UTC, TAI-UTC, Greenwich mean and apparent sidereal time. The local-time route turns a historical local clock time and place into UT.
Get a free key Try it in the playground API reference
What you get
- Julian day in UTC, UT1, TT and TDB; MJD; Julian centuries
- Delta T, UT1-UTC, TAI-UTC
- Greenwich mean and apparent sidereal time
- Local clock time + place to UT with the historical offset (local-time)
Example
curl -X POST https://astro-agent.dev/v1/astronomy/time -H 'Content-Type: application/json' \
-H "X-Credits-Token: $ASTRO_AGENTS_KEY" -d '{"datetime":"2026-11-20T12:00:00Z"}'
A real answer to this request (excerpt). The same request always returns the same
result_sha256, which POST https://astro-agent.dev/v1/verify recomputes for free:
{
"endpoint": "astronomy/time",
"result": {
"julian_day": {
"utc": 2461365.0,
"ut1": 2461365.000001,
"tt": 2461365.000801,
"tdb": 2461365.000801
},
"modified_julian_day": 61364.5,
"delta_t_seconds": 69.0976,
"ut1_minus_utc_seconds": 0.0864,
"sidereal_time": {
"gmst_hours": 15.967875,
"gast_hours": 15.968015
}
},
"meta": {
"result_sha256": "28071cfef3268eac1516eab419c37b6b18156d7f39a8649555bb355dcde5b7e1"
}
}
Routes and prices
| Route | Name | Price per call | What it returns |
|---|---|---|---|
POST /v1/astronomy/time | Julian day, sidereal time, Delta T and time scales | $0.01 | One moment in every astronomical time scale: UTC, unix time, Julian day (UTC, UT1, TT, TDB), MJD, Julian centuries, Delta T, TAI-UTC, UT1-UTC, Greenwich and local mean and apparent sidereal time. |
POST /v1/astronomy/local-time | Local time resolver (historical time zones) | $0.01 | Local time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time. |
POST /v1/astronomy/convert | Coordinate conversion between sky frames | $0.01 | Convert one direction on the sky between equatorial (J2000 and of date), ecliptic (J2000 and of date), galactic and, with a moment and a place, horizontal coordinates. |
The same routes are MCP tools on https://astro-agent.dev/mcp.
Limits
- Dates from 1800 to 2200; range routes take up to a year per call.
- Without a key: 1 free call on the $0.01-0.02 routes, then HTTP 402 with a pay-per-call offer (USDC, x402).
- Free key (an email, no card): 10,000 calls a month, 30 a minute, personal, research and evaluation use only. Paid plans from $19 a month by card, for commercial use: see pricing.
- Past the quota, calls answer 429 until the 1st of the month: nothing is charged beyond the plan.
Alternatives
For a plain calendar-date to Julian-day conversion, JPL's jd_cal API is free. We found no hosted API that returns Delta T and UT1, TT and TDB together.
Checked on the providers' own pages on 2026-11-20. Their terms may have changed since.
When Astro Agents fits
- Scientific and historical software that converts between time scales
- Resolving historical local times before computing anything
- Reproducible, hashed results