Developer · API reference

Daily Horoscope API (v1)

Honest, reflective daily readings for all twelve signs, computed from the real sky. One clean JSON call. Get a free key →

Base URL

https://sacredvela.com/api/v1

Authentication

Send your key on every request, either as a bearer token or the x-api-key header:

Authorization: Bearer vela_live_…
# or
x-api-key: vela_live_…

Create, view, and revoke keys in your developer dashboard. Keep keys secret; if one leaks, revoke it and issue a new one.

Rate limits

Quota is metered per account per UTC day and resets at 00:00 UTC. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; over the cap you get 429 with a Retry-After.

GET /api/v1/daily returns all twelve signs and counts as a single request.

Endpoints

GET /api/v1/daily/{sign}

Today’s reading for one sign. sign is a lowercase name: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. Query by whichever sign you like: a caller uses their Sun sign, their rising sign, or both.

GET /api/v1/daily/leo
Authorization: Bearer YOUR_KEY

200 OK
{
  "sign": "Leo",
  "date": "2026-07-05",
  "sky": "The Moon is a waning crescent (18% lit) in Scorpio; Sun in
          Cancer, Mercury retrograde in Cancer, Venus in Leo, Mars in Gemini.",
  "reflection": "Where are you performing warmth today rather than feeling it?",
  "disclaimer": "For entertainment and self-reflection. Not a prediction.",
  "source": "reflection"
}

GET /api/v1/daily

All twelve signs in one call (counts as one request).

GET /api/v1/daily
Authorization: Bearer YOUR_KEY

200 OK
{
  "date": "2026-07-05",
  "disclaimer": "For entertainment and self-reflection. Not a prediction.",
  "readings": [ { "sign": "Aries", ... }, ... ]  // all twelve
}

GET /api/v1

A public, unmetered discovery document listing the endpoints and current version.

Response fields

• sign: the sign name.
• date: the UTC date the reading is for (YYYY-MM-DD).
• sky: a factual line describing today’s actual planetary positions and the Moon phase, computed from the real sky.
• reflection: the reflective reading, in Vela’s voice. It ends in a question.
• disclaimer: always present; surface it to your users.
• source: engine for the day’s generated reading, or reflection for the computed fallback. Both are honest and daily-fresh.

Errors

Errors are JSON with an error string and the matching status code:

• 401: missing, invalid, or revoked key.
• 404: unknown sign.
• 429: daily quota reached (see Retry-After).

Content integrity

This API runs on the same guardrails as the Vela app. Readings are symbolic and reflective, never predictive; every one ends in a question. It refuses health, death, fertility, and definitive medical, legal, or financial topics by design. Always show the disclaimer: the readings are for entertainment and self-reflection, for adults.

Versioning & CORS

The /v1 path is stable; breaking changes ship under a new version. The API sends permissive CORS headers, so you can call it from a browser as well as a server.

Get your free key Back to the overview