{"id":"time/resolve","method":"POST","url":"https://astro-agents-api.vercel.app/v1/time/resolve","price_usd":"0.01","tier":"call","title":"Birth time resolver","summary":"Local birth time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time.","description":"The step LLMs most often get wrong. Resolves the IANA time zone from coordinates, applies the offset in force on that date (historical DST, Local Mean Time before standard time), flags ambiguous or non-existent local times instead of guessing, and returns Julian Days (UT/TT), Delta T, Local Mean Time, true (apparent) solar time and the equation of time.","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":[],"description":"Coordinates or a timezone are needed to interpret a local time."},"example_request":{"datetime":"1947-08-15T00:00","latitude":28.6139,"longitude":77.209},"example_response":{"endpoint":"time/resolve","result":{"time":{"local_input":"1947-08-15T00:00","time_basis":"civil","timezone":"Asia/Kolkata","timezone_source":"resolved_from_coordinates","utc_offset":"+05:30","is_dst":false,"utc":"1947-08-14T18:30:00Z","julian_day_ut":2432412.270996,"julian_day_tt":2432412.271322,"delta_t_seconds":28.109,"time_known":true,"local_mean_time":"1947-08-14T23:38:50","true_solar_time":"1947-08-14T23:34:10","equation_of_time_minutes":-4.6635},"location":{"latitude":28.6139,"longitude":77.209},"warnings":[{"code":"HISTORICAL_TIMEZONE","message":"offset +05:30 for Asia/Kolkata comes from the IANA tz database, whose pre-1970 history is best-effort. If the birth record states the clock offset, pass it inside 'datetime' (e.g. ...T14:30+01:00)."}]},"meta":{"engine":"astro-agents/1.0.1","ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","astronomy_library":"skyfield/1.55","frame":"geocentric apparent positions, true ecliptic and equinox of date (IAU 2006/2000A)","deterministic":true,"llm_used":false,"input_sha256":"f0c3fe0873f0faf48339eb52c7ea115f4e0cdcb93431e85199c9a41d74f2929a","result_sha256":"c44090a343c5399be2ecb9728396283b91a07114611f8cd4db69d21da16fe618","reproducibility":"result_sha256 = SHA-256 of the result serialized as JSON with sorted keys, no whitespace, UTF-8, floats rounded to 6 decimals. Same input + same engine version => same hash."},"example_note":"real output of engine 1.0.1; lists shortened to 3 items"},"payment":"x402 or MPP; first calls free. POST without payment to receive the 402 challenge.","catalog":"https://astro-agents-api.vercel.app/v1/catalog"}