WESTERN ASTROLOGY · JSON REST API

Daily Astrology Forecast API

Get a bounded sequence of daily transit snapshots against a natal chart. Each date is evaluated at local noon in the birth time zone, with the actual timestamp preserved for your application.

AvailablePOST /v1/astrology/forecast

50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗

BUILD AROUND THE DATA

What this API provides.

Build a daily astrology feed from local-noon transit samples and natal aspects. Inspect a seven-day computed response, limits and credit pricing.

01

From 1 to 365 local-calendar days

02

One local-noon sample per day

03

Moon sign and transit-to-natal cross-aspects for each sample

04

Bounded localized interpretation with explicit coverage metadata

Send

  • The birth object and its IANA time zone
  • start_date and days from 1 to 365
  • Optional house_system and locale

Receive

  • An ordered days array
  • Actual sample_at timestamps, moon_sign and transit-to-natal aspects
  • Interpretation coverage while full numerical samples remain intact
INSPECT BEFORE SUBSCRIBING

Real input. Real output.

Precomputed by the actual calculation engine and response formatter, using synthetic example data. No purchased access or paid provider call was needed.

Request JSON POST /v1/astrology/forecast
{
  "locale": "en",
  "birth": {
    "date": "1990-05-21",
    "time": "14:30:00",
    "timezone": "Europe/Madrid",
    "latitude": 40.4168,
    "longitude": -3.7038
  },
  "start_date": "2026-11-17",
  "days": 7
}
Response JSON · selected fields
{
  "request_id": "b8853d13fa751f2e3ca39f20213ff433",
  "api_version": "v1",
  "locale": "en",
  "data": {
    "sampling": "daily_local_noon_not_exact_event_times",
    "days": [
      {
        "date": "2026-11-17",
        "sample_at": "2026-11-17T11:00:00Z",
        "transits": [
          {
            "body1": "sun",
            "body2": "saturn",
            "aspect": "sextile",
            "angle": 60
          }
        ],
        "moon_sign": "aquarius"
      },
      {
        "date": "2026-11-18",
        "sample_at": "2026-11-18T11:00:00Z",
        "transits": [
          {
            "body1": "saturn",
            "body2": "uranus",
            "aspect": "square",
            "angle": 90
          }
        ],
        "moon_sign": "pisces"
      }
    ],
    "warnings": []
  },
  "interpretation": {
    "locale": "en",
    "kind": "astrology/forecast",
    "disclaimer": "Symbolic reflection, not a verified prediction or professional advice.",
    "coverage": {
      "total_facts": 163,
      "selected_facts": 163,
      "omitted_count": 0,
      "selection_method": "all-source-facts-v1",
      "full_numeric_data_unchanged": true
    },
    "method": {
      "engine": "celestack-original-rules-v1",
      "corpus": "celestack-original-compositional-v1",
      "corpus_version": "2026-11-17.2",
      "fallback_locale": null,
      "editorial_status": "agent-authored; independent linguistic review pending",
      "predictive_validity": "symbolic interpretations are not scientifically validated predictions",
      "chinese_solar_terms": "numeric calendar output only; no rule paragraphs in this corpus"
    },
    "items": [
      {
        "fact_id": "astrology/forecast.days.1.moon_sign",
        "title": "Moon · Aquarius",
        "text": "Moon · Aquarius. Zodiac: tropical. Symbolic focus: emotional needs and familiar rhythms. Test an original idea and consider its effect on others. Reference time: 2026-11-17T11:00:00Z.",
        "source": {
          "id": "astrology/forecast.days.1.moon_sign",
          "type": "astro_placement",
          "planet": "moon",
          "sign": "aquarius",
          "frame": "tropical",
          "at": "2026-11-17T11:00:00Z",
          "sampling": "daily_local_noon_not_exact_event_times"
        }
      }
    ]
  },
  "warnings": [],
  "credits_used": 10
}

The response preview selects whole fields and array entries for readability; no numeric values have been replaced. The full download preserves all fields, arrays and interpretation. The request_id is synthetic, and credits_used shows the configured successful-request cost; no credits were consumed.

cURL request — use your own API key and a new idempotency key
curl --request POST 'https://api.celestackapi.com/v1/astrology/forecast' \
+  --header 'Authorization: Bearer YOUR_API_KEY' \
+  --header 'Content-Type: application/json' \
+  --header 'Idempotency-Key: daily-forecast-api-example-001' \
+  --data '{
  "locale": "en",
  "birth": {
    "date": "1990-05-21",
    "time": "14:30:00",
    "timezone": "Europe/Madrid",
    "latitude": 40.4168,
    "longitude": -3.7038
  },
  "start_date": "2026-11-17",
  "days": 7
}'

Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗

YOUR PRODUCT, YOUR EXPERIENCE

Ways to use it.

  • A daily reflection feed
  • A calendar with consistent local-day snapshots
  • Inputs for your own daily-content selection rules

12 response locales

English, Ukrainian, Japanese, Spanish, French, German, Portuguese, Arabic, Italian, Hindi, Chinese and Korean.

Calculation values remain language-independent. Localized rule text is agent-authored; independent native-language review remains pending. Machine-readable field names stay stable.

KNOW THE CONVENTIONS

Limits and interpretation.

  • Daily samples are not an exhaustive calendar of exact aspect crossings. Use aspect-calendar for exact events.
  • Skipped or otherwise invalid local noons are rejected rather than silently shifted to another date.
  • Interpretation selects at most 256 whole source facts for large results; full numerical data remain unchanged.

Interpretive content is for symbolic reflection and entertainment. It is not a verified personal prediction or professional advice. Read the API conventions ↗

PREDICTABLE ACCESS

Choose your billing.

Both options include 50,000 credits per monthly allowance, resetting monthly. No trial and no automatic overage. Custom needs use a contact form.

5,000credits per UTC day
60requests per minute
5,000new operation attempts per UTC day
32 MiBmaximum stored JSON result

Saved results: 7-day retention, up to 128 MiB per organization on this initial shared deployment, with a 512 MiB shared retained-result limit. Capacity can return a temporary error; there are no automatic extra charges. Production artifacts have separate retention. All usage and resource limits ↗. Checkout availability is shown in your account.

DEVELOPER QUESTIONS

Frequently asked questions.

Will this find every aspect during the day?

No. It samples once at local noon. An aspect can cross between samples; the exact aspect calendar is the appropriate endpoint for those crossing times.

How are credits calculated?

The cost is 10 credits per started 30-day block. A 7-day or 30-day request costs 10; 31 days costs 20; 365 days costs 130.

Does a long forecast lose numerical samples?

No. The full data array remains intact. Only the separate interpretation is bounded, with coverage reporting the selected and omitted fact counts.

What does access cost?

Access is USD 39.99 per month or USD 199 billed annually, with no trial. Both billing options provide 50,000 credits per monthly allowance. 10 credits per started 30-day block; 1–365 days per request Daily credit, attempt, rate and resource limits apply. There are no automatic overage charges.

CONNECT THE BUILDING BLOCKS

Related APIs.

View every API