Open App Get API Key
HomeFeaturesPricingAPIAboutOpen App
REST + WebSocket · OpenAPI 3.0

Build with Planetary
Timing Intelligence

Add TQS scoring, planetary hour calculations, and forward search to your own applications. Sub-arcsecond astronomical precision via a simple REST API.

Explore Endpoints View API Plans

One Request.
Complete Timing Data.

Get the current planetary hour with full state — ruler, dignity, aspects, moon phase, and TQS for any activity — in a single API call.

JSON responses, OpenAPI/Swagger docs
API key authentication, per-plan rate limiting
WebSocket endpoint for live hour transitions
Swiss Ephemeris precision (NASA JPL DE431)
request.sh
# Get current planetary hour curl "https://api.astrotiming.com/v1/hours/current \ ?lat=31.5497&lng=74.3436" \ -H "Authorization: Bearer YOUR_API_KEY"
response.json
{ "hour_number": 8, "planet": "Sun", "start": "2026-02-23T14:15:00+05:00", "end": "2026-02-23T15:31:00+05:00", "is_daytime": true, "day_ruler": "Moon", "dignity": "peregrine", "is_retrograde": false, "sign": "Pisces", "degree": 4.18 }

Complete API Reference

All endpoints return JSON. Authentication via Bearer token. Rate limits vary by plan.

GET
/v1/hours/current
Current planetary hour for a location with full state
GET
/v1/hours
All 24 planetary hours for a given date and location
GET
/v1/planets
Current positions, dignities, and aspects for all 7 planets
GET
/v1/moon
Moon phase, sign, illumination, and void-of-course status
GET
/v1/score
TQS score for a specific activity at a specific datetime
GET
/v1/score/now
Live TQS scores for all user activities at the current moment
GET
/v1/search
Forward search: find best windows in the next N days
POST
/v1/schedule/generate
Generate an optimized weekly schedule from priorities
GET
/v1/forecast
Hourly forecast with top activities per hour for N days
GET
/v1/briefing
Morning briefing: today's top opportunities and warnings
WS
/ws/v1/stream
WebSocket: live hour transitions, countdowns, score updates

Full TQS Breakdown
in Every Response

Every score endpoint returns the full 6-factor breakdown plus a human-readable reasoning string. Build transparent, trustworthy timing features in your app.

score_response.json
{ "activity": "Product Launch", "tqs_score": 88, "level": "excellent", "breakdown": { "hour_match": 95, "day_harmony": 80, "dignity": 90, "lunar": 85, "aspects": 88, "retrograde": 80 }, "reasoning": "Sun Hour on Jupiter Day. Sun in Pisces (neutral). Trine to Jupiter. Moon waxing in Virgo. No retrogrades affecting ruler." }

Start Building Today

Get your API key in under a minute. 1,000 free calls per day on the Starter plan.

Get API Key  → Read Docs