Zodiac & birthstone for a date API

Compute the western (tropical) sun-sign from month/day boundaries plus its element, modality, and ruling planet; the Chinese zodiac animal and element from the year cycle; and the traditional birthstone for a given date. The date→sign boundary math is deterministic where LLMs slip. Answers 'what zodiac sign is March 25', 'Chinese zodiac for 1990', 'birthstone for January', 'what's my star sign'.

Price$0.01per request

MethodPOST

Route/v1/ref/zodiac

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refzodiacastrologyhoroscopebirthstonechinese-zodiacsigndate

API URLhttps://x402.hexl.dev/v1/ref/zodiac

Integration docs

Example request

{
  "date": "1990-03-25"
}

Example response

{
  "date": "1990-03-25",
  "western": {
    "sign": "Aries",
    "element": "Fire",
    "modality": "Cardinal",
    "rulingPlanet": "Mars"
  },
  "chinese": {
    "animal": "Horse",
    "element": "Metal",
    "sign": "Metal Horse"
  },
  "birthstone": "Aquamarine"
}

Input schema

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "examples": [
        "1990-03-25"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}