Endpoint
GET /api/reading
Returns a JSON reading for a given zodiac sign and date.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
sign | string | Yes | Zodiac sign name (e.g. aries, scorpio) |
date | string | No | ISO date (YYYY-MM-DD). Defaults to today. |
birthdate | string | No | ISO date. Refines score with natal data. |
Example
curl "https://deployhoroscope.com/api/reading?sign=aries"{
"sign": "aries",
"date": "2026-03-31",
"score": 73,
"verdict": "green",
"verdict_label": "DEPLOY",
"verdict_text": "The stars are aligned...",
"moon_phase": 0.42,
"moon_emoji": "\ud83c\udf14",
"retrograde_planets": [],
"chinese_sign": "Snake",
"breakdown": ["Base (cosmic seed): +54", "..."]
}Rate limits
1 request per minute per IP. Exceeding the limit returns 429 Too Many Requests with a Retry-After header. Cache aggressively.
Error responses
| Status | Cause |
|---|---|
400 | Invalid sign, date, or birthdate parameter |
429 | Rate limit exceeded |
For entertainment purposes only. Do not integrate this into your actual CI/CD pipeline. (But if you do, tell us.)