Docs
Open Lodol
DocumentationIntegrationsAPI

CosmyDay Astrology

App · 9 actions

Horoscopes and astrology from CosmyDay. Get daily, weekly and monthly horoscopes for one zodiac sign or all twelve, today's moon phase and planets, a reading for the week ahead and the month, and a calendar of upcoming retrogrades, eclipses and full moons with exact times. Work out a birth chart from a date, time and place of birth. No account or API key required.

Actions

ActionWhat it does
Calculate a birth chartWork out someone's birth chart from when and where they were born: their sun, moon and rising signs, the sign and house of every planet, and the angles between them.
Find a placeLook up a town or city by name and get its full name and map coordinates, to check a birthplace before calculating a birth chart.
Get a horoscopeGet the horoscope for one zodiac sign: today's, this week's, this month's, or the one for a month you choose.
Get horoscopes for every signGet all twelve horoscopes at once, from Aries to Pisces, for today, this week or this month.
Get the week aheadGet a short reading for each of the next seven days, with the moon's sign and phase and how high-energy the day is likely to feel.
Get this month's sky overviewGet an overview of this month for everyone, not one sign: the new and full moons with their times, the retrogrades and other turning points, and a reading on the month's overall energy.
Get today's moon phaseFind out the moon's phase today, how much of it is lit, which sign it is in, and a short reading on what that means for the day.
Get today's skySee where every planet is today, which ones are retrograde and the day's strongest alignments between them, with a reading on the day's overall mood.
List upcoming sky eventsList the retrogrades, eclipses, new and full moons, zodiac seasons and planet sign changes coming up, soonest first, each with its exact date and time and a plain explanation.

Calculate a birth chart

Work out someone's birth chart from when and where they were born: their sun, moon and rising signs, the sign and house of every planet, and the angles between them. The time is the local clock time where they were born.

Inputs

Date of birthbirth_datedateRequired
The day they were born, from 1900 to 2100.
Time of birthbirth_timetime
The local time they were born. Leave empty if unknown and noon is used: the sun sign stays right, but the rising sign and houses may not.
Place of birthbirth_placetext
The town or city they were born in, ideally with its country, such as Leeds, United Kingdom. Leave empty if you fill in Latitude and Longitude instead.
Latitudelatitudenumber
Only if you know the exact spot: the birthplace's latitude, from -90 (south) to 90 (north). Used instead of Place of birth.From -90 to 90.
Longitudelongitudenumber
Only if you know the exact spot: the birthplace's longitude, from -180 (west) to 180 (east).From -180 to 180.

Outputs

aspectslist
The angles between the planets.
birth_datetext
The date used, YYYY-MM-DD.
birth_placetext
The place used, as it was found.
birth_timetext
The local time used, HH:MM.
house_systemtext
How the houses were divided: Placidus.
houseslist
The 12 houses and the sign each starts in.
latitudenumber
The place's latitude.
linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
longitudenumber
The place's longitude.
midheaven_signtext
The sign at the top of the chart.
moon_signtext
The sign the moon was in.
part_of_fortuneobject
Where the Part of Fortune falls.
planetslist
Every planet and point in the chart.
rising_signtext
Their rising sign (ascendant).
sun_signtext
Their sun sign, the one people mean by 'star sign'.
Example output
{
  "aspects": [
    {
      "applying": true,
      "aspect": "square",
      "first_planet": "Sun",
      "orb": 5.4,
      "second_planet": "Moon"
    }
  ],
  "birth_date": "1990-06-15",
  "birth_place": "New York City, New York, United States",
  "birth_time": "14:30",
  "house_system": "Placidus",
  "houses": [
    {
      "degree": 13.7,
      "house": 1,
      "sign": "Libra"
    },
    {
      "degree": 10.77,
      "house": 2,
      "sign": "Scorpio"
    }
  ],
  "latitude": 40.71427,
  "link": "https://cosmyday.com/natal-chart",
  "longitude": -74.00597,
  "midheaven_sign": "Cancer",
  "moon_sign": "Pisces",
  "part_of_fortune": {
    "degree": 19.09,
    "house": 4,
    "sign": "Capricorn"
  },
  "planets": [
    {
      "degree": 24.39,
      "dignity": "neutral",
      "house": 9,
      "planet": "Sun",
      "retrograde": false,
      "sign": "Gemini"
    },
    {
      "degree": 18.99,
      "dignity": "neutral",
      "house": 6,
      "planet": "Moon",
      "retrograde": false,
      "sign": "Pisces"
    }
  ],
  "rising_sign": "Libra",
  "sun_sign": "Gemini"
}

Find a place

Look up a town or city by name and get its full name and map coordinates, to check a birthplace before calculating a birth chart. Returns the best match and up to seven others.

Inputs

PlaceplacetextRequired
The town or city to look up, ideally with its country.

Outputs

countnumber
How many places matched.
country_codetext
Two-letter country code, e.g. GB.
foundtrue/false
True when at least one place matched.
full_nametext
The best match with region and country.
latitudenumber
The best match's latitude.
longitudenumber
The best match's longitude.
nametext
The best match's name.
placeslist
Every match, best first.
Example output
{
  "count": 2,
  "country_code": "GB",
  "found": true,
  "full_name": "Leeds, England, United Kingdom",
  "latitude": 53.79648,
  "longitude": -1.54785,
  "name": "Leeds",
  "places": [
    {
      "country_code": "GB",
      "full_name": "Leeds, England, United Kingdom",
      "latitude": 53.79648,
      "longitude": -1.54785,
      "name": "Leeds"
    },
    {
      "country_code": "US",
      "full_name": "Leeds, Alabama, United States",
      "latitude": 33.54816,
      "longitude": -86.54443,
      "name": "Leeds"
    }
  ]
}

Get a horoscope

Get the horoscope for one zodiac sign: today's, this week's, this month's, or the one for a month you choose. Each is a few paragraphs on work, relationships and mood, ready to post or send, and weekly and monthly ones list the key dates too.

Inputs

Zodiac signsigntextRequired
The star sign to get the horoscope for.One of: aries (Aries (Mar 21 - Apr 19)), taurus (Taurus (Apr 20 - May 20)), gemini (Gemini (May 21 - Jun 20)), cancer (Cancer (Jun 21 - Jul 22)), leo (Leo (Jul 23 - Aug 22)), virgo (Virgo (Aug 23 - Sep 22)), libra (Libra (Sep 23 - Oct 22)), scorpio (Scorpio (Oct 23 - Nov 21)), sagittarius (Sagittarius (Nov 22 - Dec 21)), capricorn (Capricorn (Dec 22 - Jan 19)), aquarius (Aquarius (Jan 20 - Feb 18)), pisces (Pisces (Feb 19 - Mar 20)). Default: aries.
Horoscope forperiodtext
Today's, this week's (Monday to Sunday) or this month's horoscope, or the one for a month you pick.One of: today, this_week (This week), this_month (This month), chosen_month (A month you choose). Default: today.
Monthmonthdate
Any day in the month you want. CosmyDay writes monthly horoscopes ahead of time, so the coming months work too.Only when Horoscope for is A month you choose.

Outputs

closingtext
A short closing thought to end on.
ends_ontext
The last day it covers, YYYY-MM-DD.
horoscopetext
The horoscope itself: a few paragraphs on work, relationships and mood, with a heading and emoji, ready to send.
key_dateslist
The days that matter most in the period, each with a short title and what it means. Empty for a daily horoscope.
linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
periodtext
Which horoscope this is: Today, This week, This month...
signtext
The zodiac sign, e.g. Leo.
starts_ontext
The first day it covers, YYYY-MM-DD.
Example output
{
  "closing": "This week's powerful Sun-Jupiter connection in your sign, Leo, truly highlights your potential for growth and expansion.",
  "ends_on": "2026-10-18",
  "horoscope": "\u2728 Week of 2026-10-12 \u2014 Leo\n\n\ud83c\udfaf This week's theme: A powerful surge of expansive energy lights up your path, Leo, inviting you to embrace new possibilities with confidence.",
  "key_dates": [
    {
      "date": "2026-10-12",
      "description": "Your ruler, the Sun, connects with Jupiter in your sign, bringing a surge of optimism and opportunity.",
      "title": "Expansive Opportunities"
    }
  ],
  "link": "https://cosmyday.com/horoscope/leo/weekly",
  "period": "This week",
  "sign": "Leo",
  "starts_on": "2026-10-12"
}

Get horoscopes for every sign

Get all twelve horoscopes at once, from Aries to Pisces, for today, this week or this month. The one to use for a newsletter, a daily post or a channel that covers every sign.

Inputs

Horoscopes forperiodtext
Today's, this week's or this month's horoscopes.One of: today, this_week (This week), this_month (This month). Default: today.

Outputs

countnumber
How many signs came back: 12.
ends_ontext
The last day they cover, YYYY-MM-DD.
horoscopeslist
One horoscope per sign, in zodiac order from Aries to Pisces. Loop over this to send each one on.
periodtext
Today, This week or This month.
starts_ontext
The first day they cover, YYYY-MM-DD.
Example output
{
  "count": 12,
  "ends_on": "2026-10-15",
  "horoscopes": [
    {
      "closing": "Today, with the Moon in adventurous Sagittarius, your spirit is naturally drawn to the big picture and what truly matters.",
      "ends_on": "2026-10-15",
      "horoscope": "\u2728 Thursday, October 15 \u2014 Aries\n\n\ud83e\ude90 Overview: Aries, with your ruler Mars in Leo and the Moon in adventurous Sagittarius, your natural fire and pioneering spirit are highlighted today.",
      "key_dates": [],
      "link": "https://cosmyday.com/horoscope/aries/daily",
      "period": "Today",
      "sign": "Aries",
      "starts_on": "2026-10-15"
    },
    {
      "closing": "Today's intense focus on your ruling planet, Venus, offers a powerful glimpse into the forces shaping your desires.",
      "ends_on": "2026-10-15",
      "horoscope": "\u2728 Thursday, October 15 \u2014 Taurus\n\n\ud83e\ude90 Overview: Taurus, today brings a significant internal spotlight, as your ruling planet Venus is in direct tension with Pluto.",
      "key_dates": [],
      "link": "https://cosmyday.com/horoscope/taurus/daily",
      "period": "Today",
      "sign": "Taurus",
      "starts_on": "2026-10-15"
    }
  ],
  "period": "Today",
  "starts_on": "2026-10-15"
}

Get the week ahead

Get a short reading for each of the next seven days, with the moon's sign and phase and how high-energy the day is likely to feel. Good for a Monday post or a planning email.

Inputs

None.

Outputs

countnumber
How many days came back: usually 7.
dayslist
One entry per day, in order.
ends_ontext
The last day, YYYY-MM-DD.
linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
starts_ontext
The first day, YYYY-MM-DD (today).
Example output
{
  "count": 7,
  "days": [
    {
      "date": "2026-10-15",
      "energy_level": "high",
      "illumination_percent": 21.7,
      "moon_phase": "Waxing Crescent",
      "moon_sign": "Sagittarius",
      "reading": "Get ready for a vibrant, high-energy day! Today brings a wonderful sense of optimism and support as the Sun aligns with Jupiter.",
      "weekday": "Thursday"
    }
  ],
  "ends_on": "2026-10-21",
  "link": "https://cosmyday.com/sky-today",
  "starts_on": "2026-10-15"
}

Get this month's sky overview

Get an overview of this month for everyone, not one sign: the new and full moons with their times, the retrogrades and other turning points, and a reading on the month's overall energy.

Inputs

None.

Outputs

linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
lunationslist
The month's new and full moons.
major_eventslist
The month's turning points, in date order.
monthnumber
The month, 1-12.
month_nametext
The month's name, e.g. October.
overviewtext
A reading on the month as a whole.
yearnumber
The year.
Example output
{
  "link": "https://cosmyday.com/horoscope",
  "lunations": [
    {
      "date": "2026-10-10",
      "sign": "Libra",
      "time_eastern": "11:50 AM",
      "type": "New moon"
    },
    {
      "date": "2026-10-26",
      "sign": "Taurus",
      "time_eastern": "12:11 AM",
      "type": "Full moon"
    }
  ],
  "major_events": [
    {
      "date": "2026-10-03",
      "event": "Venus stations retrograde in Scorpio"
    },
    {
      "date": "2026-10-24",
      "event": "Mercury stations retrograde in Scorpio"
    }
  ],
  "month": 10,
  "month_name": "October",
  "overview": "\ud83c\udf1f October 2026 \u2014 Cosmic Overview\n\n**The month's energy**\n\nOctober arrives with a blend of potent energies, inviting us to navigate intensity with grace and embrace meaningful transformation.",
  "year": 2026
}

Get today's moon phase

Find out the moon's phase today, how much of it is lit, which sign it is in, and a short reading on what that means for the day.

Inputs

None.

Outputs

datetext
Today, YYYY-MM-DD.
illumination_percentnumber
How much of the moon is lit, 0 to 100.
linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
moon_degreenumber
How far through that sign it is, 0 to 30.
moon_signtext
The zodiac sign the moon is in.
phasetext
The phase, e.g. Waxing Crescent or Full Moon.
readingtext
A short reading on the day's moon.
Example output
{
  "date": "2026-10-15",
  "illumination_percent": 21.7,
  "link": "https://cosmyday.com/moon-calendar",
  "moon_degree": 17.6,
  "moon_sign": "Sagittarius",
  "phase": "Waxing Crescent",
  "reading": "Today, with the Moon building momentum as a Waxing Crescent in adventurous Sagittarius, you may feel a push to explore new ideas."
}

Get today's sky

See where every planet is today, which ones are retrograde and the day's strongest alignments between them, with a reading on the day's overall mood.

Inputs

None.

Outputs

aspectslist
The day's strongest alignments.
datetext
Today, YYYY-MM-DD.
headlinetext
The reading's title line.
linktext
The matching page on cosmyday.com. CosmyDay asks for a visible link to it wherever you show this.
planetslist
Where each planet and point is today.
readingtext
A few paragraphs on the day's mood.
retrograde_planetslist
The planets that are retrograde today.
Example output
{
  "aspects": [
    {
      "aspect": "sextile",
      "first_planet": "Sun",
      "orb": 0.13,
      "second_planet": "Jupiter"
    }
  ],
  "date": "2026-10-15",
  "headline": "\u2b50 Today's Cosmic Current: Big Dreams Meet Deep Reflections",
  "link": "https://cosmyday.com/sky-today",
  "planets": [
    {
      "degree": 22.2,
      "planet": "Sun",
      "retrograde": false,
      "sign": "Libra"
    },
    {
      "degree": 5.6,
      "planet": "Venus",
      "retrograde": true,
      "sign": "Scorpio"
    }
  ],
  "reading": "\u2b50 Today's Cosmic Current: Big Dreams Meet Deep Reflections\n\nToday, the cosmic weather brings a mix of expansive thinking and intense personal reflection.",
  "retrograde_planets": [
    "Venus",
    "Saturn",
    "Uranus",
    "Neptune",
    "Pluto"
  ]
}

List upcoming sky events

List the retrogrades, eclipses, new and full moons, zodiac seasons and planet sign changes coming up, soonest first, each with its exact date and time and a plain explanation. Use it to post a reminder before Mercury goes retrograde or to fill a calendar.

Inputs

Days aheaddaysnumber
How far ahead to look, in days. Up to 400.From 1 to 400. Default: 30.
Type of eventevent_typetext
Only list one type of event, such as full moons or eclipses. Leave empty for every type.
Importanceimportancetext
Leave out the minor ones. Notable keeps moons, seasons, retrogrades and eclipses and drops most planet sign changes.One of: all (Everything, including minor sign changes), notable (Notable events only), major (Only the biggest: eclipses and major retrogrades). Default: all.
Starting fromstart_datedate
The first day to look from. Leave empty to start today.
Most eventslimitnumber
The most events to return, up to 200.From 1 to 200. Default: 50.

Outputs

calendar_endstext
The latest day CosmyDay's calendar has.
calendar_startstext
The earliest day CosmyDay's calendar has.
countnumber
How many events came back.
eventslist
The events, soonest first.
from_datetext
The first day looked at, YYYY-MM-DD.
to_datetext
The last day looked at, YYYY-MM-DD.
Example output
{
  "calendar_ends": "2030-12-09",
  "calendar_starts": "2025-11-11",
  "count": 2,
  "events": [
    {
      "date": "2026-10-24",
      "details": "Mercury appears to reverse through the zodiac from October 24, 2026 until November 13, 2026, stationing at 21\u00b0 Scorpio and turning direct at 5\u00b0 Scorpio.",
      "headline": "Mercury goes retrograde",
      "importance": 90,
      "link": "https://cosmyday.com/retrograde-calendar",
      "sign": "Scorpio",
      "summary": "Mercury stations retrograde at 21\u00b0 Scorpio on October 24, 2026, and turns direct again on November 13, 2026.",
      "time_eastern": "",
      "type": "retrograde_start",
      "type_label": "A planet turns retrograde"
    },
    {
      "date": "2026-10-26",
      "details": "The Full Moon falls at 2\u00b0 Taurus on October 26, 2026 at 12:12 AM Eastern. It is traditionally read as culmination and release.",
      "headline": "Full Moon in Taurus",
      "importance": 60,
      "link": "https://cosmyday.com/moon-calendar",
      "sign": "Taurus",
      "summary": "The Full Moon reaches 2\u00b0 Taurus at 12:12 AM ET on October 26, 2026.",
      "time_eastern": "12:12 AM",
      "type": "full_moon",
      "type_label": "Full moon"
    }
  ],
  "from_date": "2026-10-15",
  "to_date": "2026-11-14"
}

CorpStacking

Previous Page

countries.dev

Next Page

On this page

ActionsCalculate a birth chartFind a placeGet a horoscopeGet horoscopes for every signGet the week aheadGet this month's sky overviewGet today's moon phaseGet today's skyList upcoming sky events