Daily Horoscope

Get a daily horoscope for a zodiac sign, with mood, energy ratings, and advice. Costs 1 credit.

POST /v1/horoscope

Parameters

Name	Type	Required	Description
`sign`	string	Yes	Zodiac sign: aries, taurus, … pisces.
`date`	string	No	Date for the reading, `YYYY-MM-DD`. Defaults to today.

Example request

curl -X POST https://api.gitstrology.dev/v1/horoscope \
  -H "X-API-Key: $GITSTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sign": "aries",
    "date": "2026-08-02"
  }'

Example response

{
  "data": {
    "date": "2026-08-02",
    "sign": "aries",
    "mood": "ambitious",
    "energy": 4,
    "luck": 3,
    "love": 5,
    "career": 4,
    "summary": "Aries energy is running high today...",
    "advice": "Channel your fire into one decisive action today.",
    "luckyNumber": 42,
    "luckyColor": "gold"
  },
  "credits": { "used": 1, "remaining": 99 }
}

Response fields

Field	Type	Description
`data.date`	string	Date of the reading.
`data.sign`	string	Zodiac sign queried.
`data.mood`	string	One-word mood descriptor.
`data.energy`	number	Energy rating, 1–5.
`data.luck`	number	Luck rating, 1–5.
`data.love`	number	Love rating, 1–5.
`data.career`	number	Career rating, 1–5.
`data.summary`	string	Short narrative summary.
`data.advice`	string	One line of actionable advice.
`data.luckyNumber`	number	Lucky number of the day.
`data.luckyColor`	string	Lucky color of the day.