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.
Quick Start
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 + OpenAPI
JSON responses, OpenAPI/Swagger docs, auto-generated client SDKs for major languages.
Bearer Auth
API key authentication with per-plan rate limiting and clear 429 responses.
Live Streaming
WebSocket endpoint for live hour transitions, countdowns, and real-time score updates.
NASA Precision
Swiss Ephemeris with JPL DE431 data — sub-arcsecond accuracy for all seven classical planets.
Complete API Reference
/v1/hours/current
Current planetary hour for a location with full state.
/v1/hours
All 24 planetary hours for a given date and location.
/v1/planets
Current positions, dignities, and aspects for all 7 planets.
/v1/moon
Moon phase, sign, illumination, and void-of-course status.
/v1/score
TQS score for a specific activity at a specific datetime.
/v1/score/now
Live TQS scores for all user activities at the current moment.
/v1/search
Forward search: find best windows in the next N days.
/v1/schedule/generate
Generate an optimized weekly schedule from priorities.
/v1/forecast
Hourly forecast with top activities per hour for N days.
/v1/briefing
Morning briefing: today’s top opportunities and warnings.
/ws/v1/stream
WebSocket: live hour transitions, countdowns, score updates.
Scoring API
“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.”
Start Building *Today*
Get your API key in under a minute. 1,000 free calls per day on the Starter plan.