Cyclecalcs

CycleCalcs Astronomy API

A read-only astronomy API that returns the named answer and the numbers behind it, with the frame, epoch, time scale and refraction model stated on every…

Data & analytics#science--math

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

A read-only astronomy API that returns the named answer and the numbers behind it, with the frame, epoch, time scale and refraction model stated on every response. It reports angles, times and names, and attaches no meaning to any of them. Computed in real time with the MIT-licensed Astronomy Engine. This document is generated from the shipped route table (netlify/lib/v2/registry.mjs) by tools/generate-openapi.mjs, so it cannot list a route, a parameter or a requirement the API does not actually enforce. Computed astronomical output is unrestricted: use, store, redistribute and sell it without attribution. The one exception is GeoNames place data served by GET /v2/places and by any response that resolved a place parameter, which requires the credit line in meta.attribution; see GET /v2/attribution for the full source register.

Endpoints 32

  • GETThe discovery document: every endpoint, parameter, convention and limit/v2The discovery document: every endpoint, parameter, convention and limit. Formats: json. Example: GET /v2
  • GETEvery convention, threshold, model and limit the API uses, as data/v2/conventionsEvery convention, threshold, model and limit the API uses, as data. Formats: json. Example: GET /v2/conventions
  • GETEvery enumerated value the API can emit or accept, as data/v2/enumsEvery enumerated value the API can emit or accept, as data. Formats: json. Some fields are currently withheld: The meteor_showers set is withheld until the…
  • GETEvery source behind every endpoint, with its license and what it obliges a caller to do/v2/attributionEvery source behind every endpoint, with its license and what it obliges a caller to do. Formats: json. Example: GET /v2/attribution?endpoint=/v2/moon
  • GETWhere every body is, in every frame, with refraction stated/v2/positionsWhere every body is, in every frame, with refraction stated. Formats: json, csv. Example: GET…
  • GETRise, transit, set and lower transit for any named object, with an explicit status at every latitude/v2/rise-set?body=moon&lat=51.4778&lon=-0.0015Rise, transit, set and lower transit for any named object, with an explicit status at every latitude. Formats: json, csv. Example: GET…
  • GETThe complete solar day: every named boundary, azimuth, day length and polar status/v2/sun?lat=51.4778&lon=-0.0015The complete solar day: every named boundary, azimuth, day length and polar status. Formats: json, csv, txt. Example: GET…
  • GETThe Moon in render-ready form: phase, illumination, bright limb, libration/v2/moonThe Moon in render-ready form: phase, illumination, bright limb, libration. Formats: json, csv, txt. Example: GET…
  • GETEvery time scale, sidereal time, solar time, the equation of time and the Julian dates/v2/timeEvery time scale, sidereal time, solar time, the equation of time and the Julian dates. Formats: json, csv. Example: GET…
  • GETEvery equinox and solstice in a window, with the length of each season they bound, and on request the cross-quarters and all 24 solar terms/v2/seasonsEvery equinox and solstice in a window, with the length of each season they bound, and on request the cross-quarters and all 24 solar terms. Formats: json,…
  • GETEvery perigee, apogee, perihelion and aphelion in a window, with its distance/v2/apsidesEvery perigee, apogee, perihelion and aphelion in a window, with its distance. Formats: json, csv. Example: GET…
  • GETEvery crossing of the ecliptic by the Moon, the node longitudes and the eclipse seasons they define/v2/moon-nodesEvery crossing of the ecliptic by the Moon, the node longitudes and the eclipse seasons they define. Formats: json, csv. Example: GET…
  • GETSolar and lunar eclipses with global geometry, local circumstances and an explicit answer to whether you can see it/v2/eclipsesSolar and lunar eclipses with global geometry, local circumstances and an explicit answer to whether you can see it. Formats: json, csv, txt. Some fields are…
  • GETAll eight planets in one request: place, brightness, apparent size, retrograde state, next station and whether it is worth looking tonight/v2/planet-boardAll eight planets in one request: place, brightness, apparent size, retrograde state, next station and whether it is worth looking tonight. Formats: json,…
  • GETEvery retrograde and direct station of every planet in a window, with the loop length, its arc, and the interval of triple crossing/v2/retrogradesEvery retrograde and direct station of every planet in a window, with the loop length, its arc, and the interval of triple crossing. Formats: json, csv.…
  • GETClose approaches between body pairs in a window, ranked, with the separation and whether the pair is observable or lost in twilight/v2/conjunctionsClose approaches between body pairs in a window, ranked, with the separation and whether the pair is observable or lost in twilight. Formats: json, csv.…
  • GETThe angular separation between any two targets at an instant, and the minima of that separation across a window/v2/separation?a=jupiter&b=saturnThe angular separation between any two targets at an instant, and the minima of that separation across a window. Formats: json, csv, txt. Example: GET…
  • GETHow rare a pairing is: for two targets at an instant, the most recent earlier pairing that was at least as close and the next one, searched up to ten years each way; with a location, by default only pairings seen in a dark sky with both targets up count/v2/rarity?a=moon&b=jupiterHow rare a pairing is: for two targets at an instant, the most recent earlier pairing that was at least as close and the next one, searched up to ten years…
  • GETWhat was in the sky at an instant from a place: the Sun, the Moon, the five naked-eye planets and the thirty brightest named stars, each with its magnitude, refracted and airless altitude and azimuth, the list the Sky Map labels a photograph with/v2/sky-targets?lat=51.4778&lon=-0.0015What was in the sky at an instant from a place: the Sun, the Moon, the five naked-eye planets and the thirty brightest named stars, each with its magnitude,…
  • GETAurora now: live Kp and storm level, the three-day Kp forecast, the solar wind and the auroral oval from NOAA SWPC; with a location, whether the oval is overhead or on your horizon, whether it is dark, and the forecast Kp over tonight's dark hours/v2/auroraAurora now: live Kp and storm level, the three-day Kp forecast, the solar wind and the auroral oval from NOAA SWPC; with a location, whether the oval is…
  • GETWhere we are in every astronomical cycle the site tracks, with an explicit statement of whether each number was computed, observed, or is an interval with no live phase/v2/cyclesWhere we are in every astronomical cycle the site tracks, with an explicit statement of whether each number was computed, observed, or is an interval with no…
  • GETAll three twilights plus day and night as non-overlapping intervals that tile the whole day, each with the reason it starts and ends, and a checksum the caller can assert/v2/twilight?lat=51.4778&lon=-0.0015All three twilights plus day and night as non-overlapping intervals that tile the whole day, each with the reason it starts and ends, and a checksum the…
  • GETThe genuinely dark moonless observing window of a night: astronomical night intersected with the Moon being down, ranked across up to 62 nights with a trend/v2/dark-window?lat=51.4778&lon=-0.0015The genuinely dark moonless observing window of a night: astronomical night intersected with the Moon being down, ranked across up to 62 nights with a trend.…
  • GETGreenwich and local sidereal time, apparent and mean side by side, with the equation of the equinoxes that separates them and the nutation terms it is built from/v2/sidereal-timeGreenwich and local sidereal time, apparent and mean side by side, with the equation of the equinoxes that separates them and the nutation terms it is built…
  • GETHow far a sundial runs ahead of or behind the clock, from the real Sun rather than a day-of-year series, with the Sun place that makes a range query an analemma/v2/equation-of-timeHow far a sundial runs ahead of or behind the clock, from the real Sun rather than a day-of-year series, with the Sun place that makes a range query an…
  • GETLunar libration, the sub-Earth point, the axis and bright-limb position angles, and with the terminator token the sub-solar point and the colongitude that fixes where the terminator falls/v2/librationLunar libration, the sub-Earth point, the axis and bright-limb position angles, and with the terminator token the sub-solar point and the colongitude that…
  • GETWhere the four Galilean moons are, and every transit, shadow transit, eclipse and occultation in the window, with both contact instants for each/v2/jupiter-moonsWhere the four Galilean moons are, and every transit, shadow transit, eclipse and occultation in the window, with both contact instants for each. Formats:…
  • GETNaked-eye limiting magnitude and aperture reach for a sky class you supply, with an explicit machine-readable statement that the number is a tuned estimate rather than a measurement/v2/sky-qualityNaked-eye limiting magnitude and aperture reach for a sky class you supply, with an explicit machine-readable statement that the number is a tuned estimate…
  • GETPlace-name search and reverse lookup against the self-hosted GeoNames index, returning name, region, country, coordinates and IANA timezone with a stable place_id/v2/placesPlace-name search and reverse lookup against the self-hosted GeoNames index, returning name, region, country, coordinates and IANA timezone with a stable…
  • GETThe lunar phase calendar: every quarter with its distance, apparent size, supermoon classification under BOTH competing rules, traditional name and any eclipse/v2/phasesThe lunar phase calendar: every quarter with its distance, apparent size, supermoon classification under BOTH competing rules, traditional name and any…
  • GETPlanet events as dated instants: the Mercury and Venus apparition cycle with its current state, the conjunctions with the Sun, quadratures and oppositions of Mars to Neptune, and IAU constellation entries for all seven/v2/planet-eventsPlanet events as dated instants: the Mercury and Venus apparition cycle with its current state, the conjunctions with the Sun, quadratures and oppositions of…
  • GETThe whole sky for a place right now, in one request/v2/todayThe whole sky for a place right now, in one request. Formats: json, txt. Some fields are currently withheld: Meteor-shower events are withheld from…

API details

Base URL
https://www.cyclecalcs.com
Authentication
An API key in the X-RapidAPI-Key header
Operations
32 operations on 32 pathsGET 32
Response formats
application/json application/problem+json text/csv text/plain
Description format
OpenAPI 3.1.0, API version 2.8.0

How to test the CycleCalcs Astronomy API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the CycleCalcs Astronomy API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-RapidAPI-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “The discovery document: every endpoint, parameter, convention and limit” (GET /v2), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the CycleCalcs Astronomy API?

A read-only astronomy API that returns the named answer and the numbers behind it, with the frame, epoch, time scale and refraction model stated on every… It is listed under Data & analytics and has 32 endpoints.

Who publishes the CycleCalcs Astronomy API?

It is listed from Cyclecalcs's public API description (an OpenAPI document), not published by Cyclecalcs on Swastik Codes. Anyone who controls cyclecalcs.com can claim the profile by adding a DNS TXT record.

What is the base URL of the CycleCalcs Astronomy API?

Requests go to https://www.cyclecalcs.com. Endpoint paths are added to this base URL.

How do I authenticate with the CycleCalcs Astronomy API?

With an API key in the X-RapidAPI-Key header.

How many endpoints does the CycleCalcs Astronomy API have?

32 operations on 32 paths (32 GET).

Is forking the CycleCalcs Astronomy API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.