{"openapi":"3.1.0","info":{"title":"Moon API","version":"1.0.0","description":"Everything about the Moon from one fast, fully-local API. Get the current (or any date) lunar phase with illumination percentage, age in days, phase angle and waxing/waning state, plus the matching emoji; list the upcoming principal phases (new, first quarter, full, last quarter) with accurate UTC timestamps; render a full monthly lunar calendar; and look up the Moon’s zodiac sign and ecliptic longitude. Phase instants are computed with Jean Meeus’ astronomical algorithms and are accurate to about a minute. Every endpoint takes an optional ISO date and works by GET or JSON POST. Pure server-side compute with no third-party upstream, so responses are instant and always available. Ideal for calendar and weather apps, photography and astronomy tools, gardening, fishing and astrology features.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/moon-api","description":"oanor gateway"}],"tags":[{"name":"Moon"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/astrology":{"get":{"operationId":"get_v1_astrology","tags":["Moon"],"summary":"Moon zodiac sign (beta)","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"ISO date/time (default: now)","schema":{"type":"string"},"example":"2026-01-03"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-01-03T00:00:00.000Z","note":"Tropical zodiac, geocentric mean longitude (beta, ~1Β° precision)","emoji":"πŸŒ•","phase":"Full Moon","moon_sign":"Cancer","degree_in_sign":6.75,"ecliptic_longitude":96.75,"illumination_percent":99.2},"meta":{"timestamp":"2026-05-30T18:17:11.288Z","request_id":"78c9b461-92c2-47bf-8f52-18057fed7df4"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/calendar":{"get":{"operationId":"get_v1_calendar","tags":["Moon"],"summary":"Monthly lunar calendar","description":"","parameters":[{"name":"year","in":"query","required":false,"description":"1900-2100 (default: current)","schema":{"type":"string"},"example":"2026"},{"name":"month","in":"query","required":false,"description":"1-12 (default: current)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"days":31,"year":2026,"month":1,"calendar":[{"date":"2026-01-01","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":12.43,"illumination_percent":93.9},{"date":"2026-01-02","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":13.43,"illumination_percent":98},{"date":"2026-01-03","emoji":"πŸŒ•","phase":"Full Moon","age_days":14.43,"illumination_percent":99.9},{"date":"2026-01-04","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":15.43,"illumination_percent":99.5},{"date":"2026-01-05","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":16.43,"illumination_percent":96.9},{"date":"2026-01-06","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":17.43,"illumination_percent":92.2},{"date":"2026-01-07","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":18.43,"illumination_percent":85.6},{"date":"2026-01-08","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":19.43,"illumination_percent":77.4},{"date":"2026-01-09","emoji":"πŸŒ–","phase":"Waning Gibbous","age_days":20.43,"illumination_percent":67.9},{"date":"2026-01-10","emoji":"πŸŒ—","phase":"Last Quarter","age_days":21.43,"illumination_percent":57.6},{"date":"2026-01-11","emoji":"🌘","phase":"Waning Crescent","age_days":22.43,"illumination_percent":47},{"date":"2026-01-12","emoji":"🌘","phase":"Waning Crescent","age_days":23.43,"illumination_percent":36.6},{"date":"2026-01-13","emoji":"🌘","phase":"Waning Crescent","age_days":24.43,"illumination_percent":26.7},{"date":"2026-01-14","emoji":"🌘","phase":"Waning Crescent","age_days":25.43,"illumination_percent":17.9},{"date":"2026-01-15","emoji":"🌘","phase":"Waning Crescent","age_days":26.43,"illumination_percent":10.5},{"date":"2026-01-16","emoji":"🌘","phase":"Waning Crescent","age_days":27.43,"illumination_percent":4.9},{"date":"2026-01-17","emoji":"🌘","phase":"Waning Crescent","age_days":28.43,"illumination_percent":1.4},{"date":"2026-01-18","emoji":"🌘","phase":"Waning Crescent","age_days":29.43,"illumination_percent":0},{"date":"2026-01-19","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":0.67,"illumination_percent":0.5},{"date":"2026-01-20","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":1.67,"illumination_percent":3.1},{"date":"2026-01-21","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":2.67,"illumination_percent":7.9},{"date":"2026-01-22","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":3.67,"illumination_percent":14.5},{"date":"2026-01-23","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":4.67,"illumination_percent":22.7},{"date":"2026-01-24","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":5.67,"illumination_percent":32.2},{"date":"2026-01-25","emoji":"πŸŒ’","phase":"Waxing Crescent","age_days":6.67,"illumination_percent":42.5},{"date":"2026-01-26","emoji":"πŸŒ“","phase":"First Quarter","age_days":7.67,"illumination_percent":53.1},{"date":"2026-01-27","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":8.67,"illumination_percent":63.5},{"date":"2026-01-28","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":9.67,"illumination_percent":73.4},{"date":"2026-01-29","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":10.67,"illumination_percent":82.2},{"date":"2026-01-30","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":11.67,"illumination_percent":89.6},{"date":"2026-01-31","emoji":"πŸŒ”","phase":"Waxing Gibbous","age_days":12.67,"illumination_percent":95.1}]},"meta":{"timestamp":"2026-05-30T18:17:11.369Z","request_id":"2dce4591-be7b-4612-a13c-9388cfd7a835"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/emoji":{"get":{"operationId":"get_v1_emoji","tags":["Moon"],"summary":"Phase as emoji","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"ISO date/time (default: now)","schema":{"type":"string"},"example":"2026-01-03"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-01-03T00:00:00.000Z","emoji":"πŸŒ•","phase":"Full Moon","illumination_percent":99.2},"meta":{"timestamp":"2026-05-30T18:17:11.446Z","request_id":"2501c8ba-d124-46cb-b26a-c1848c604272"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/next":{"get":{"operationId":"get_v1_next","tags":["Moon"],"summary":"Upcoming principal phases","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Start date (default: now)","schema":{"type":"string"},"example":"2026-01-03"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"from":"2026-01-03T00:00:00.000Z","next_phases":[{"date":"2026-01-03T10:03:05.620Z","emoji":"πŸŒ•","phase":"Full Moon"},{"date":"2026-01-10T15:49:40.980Z","emoji":"πŸŒ—","phase":"Last Quarter"},{"date":"2026-01-18T19:53:16.023Z","emoji":"πŸŒ‘","phase":"New Moon"},{"date":"2026-01-26T04:48:33.776Z","emoji":"πŸŒ“","phase":"First Quarter"}]},"meta":{"timestamp":"2026-05-30T18:17:11.527Z","request_id":"77f49761-6f33-4b27-b09e-b4c1f121fccc"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/phase":{"get":{"operationId":"get_v1_phase","tags":["Moon"],"summary":"Lunar phase for a date","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"ISO date/time (default: now)","schema":{"type":"string"},"example":"2026-01-03"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-01-03T00:00:00.000Z","emoji":"πŸŒ•","phase":"Full Moon","age_days":13.93,"is_waxing":true,"phase_angle":169.78,"cycle_fraction":0.4716,"illumination_percent":99.2},"meta":{"timestamp":"2026-05-30T18:17:11.599Z","request_id":"73400904-6255-4dac-b755-f37620264ad0"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":300,"monthly_call_quota":20000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1000,"monthly_call_quota":150000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2200,"monthly_call_quota":1000000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/moon-api"}