New Numerology API

AN · Annual forecast

AN-06: Five sections select from one calendar

The year's events are worked out once, and each section of the forecast picks the events that matter to its question.

See all 6 rules in this section

© API for Astrology (apiforastrology.com). "A rule page". All rights reserved. Not to be copied or reused.AN-06invention ruleFive sections select from onecalendarAnnual forecastFires for John Doe

Endpoints that apply this rule

Each call returns the rule it used, so you can match a result to AN-06.

POST/v1/forecast/annualYearly forecast: a year of sky events read against a chart

Call an endpoint that applies it

The call for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.

POST /v1/forecast/annual

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/forecast/annual?year=2026" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Answer (long lists shortened)200 OK
{
  "year": 2026,
  "sections": [
    {
      "id": "annual:annual-career",
      "title": "Annual Forecast: Career",
      "family": "annual",
      "text": [
        "Your work year is shaped mostly by the two slow planets, Saturn and Jupiter. They set the broad climate for you. The Sun, Mercury and Mars move faster, so they add shorter pushes and pauses along the way.",
        "Saturn and Jupiter change sign only once in 12 months or longer. So the houses they cross in your chart set your main career themes for the whole year: groundwork, promotions and bigger steps. A house is one of the 12 parts of your chart,…",
        "Mercury is sometimes retrograde (it seems to move backward for a few weeks). In those weeks, take extra care with contracts, launches and anything that needs clear talk. When a planet crossing your work houses is marked favorable, that is…"
      ],
      "language": "en",
      "detail": "standard",
      "events": [
        {
          "kind": "ingress",
          "graha": "Jupiter",
          "starts": "2026-01-01",
          "ends": "2026-06-01",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-06-01T16:20-04:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Gemini",
          "natal_house": 10,
          "house_from_moon": 2,
          "result": "favorable",
          "why": [
            "house"
          ],
          "text": [
            "Jupiter, the planet of growth, wisdom and good advice, stays in one sign for about 12 months. So one sign change can be the biggest dated event of your year. The house it enters, the area of life that sign covers in your chart, is where…",
            "Because it moves slowly, it works as a background, not a single episode. That part of your life is easier for a year, though you often notice the ease more looking back. If Jupiter changes sign halfway through your year, the year really…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Rahu",
          "starts": "2026-01-01",
          "ends": "2026-11-25",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-11-25T07:15-05:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Aquarius",
          "natal_house": 6,
          "house_from_moon": 10,
          "result": "favorable",
          "why": [
            "house"
          ],
          "text": [
            "Rahu is the Moon's north node, a point in the sky rather than a body. It stays in a sign for about 18 months. It moves backward, so it changes sign in the opposite direction to the other planets. The house it enters is the area of life…",
            "Rahu adds nothing of its own. It magnifies what the house already holds. So the same Rahu transit can be an opportunity in one chart and overreach in another. The house matters more here than Rahu itself. Stay steady, and talk big moves…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Saturn",
          "starts": "2026-01-01",
          "ends": "2027-01-01",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2027-01-01T00:00-05:00",
          "started_before_the_year": true,
          "runs_past_the_year": true,
          "sign": "Pisces",
          "natal_house": 7,
          "house_from_moon": 11,
          "result": "favorable",
          "why": [
            "karaka"
          ],
          "text": [
            "Saturn, the planet of duty, patience and delay, stays in one sign for about two and a half years. So in most years it does not change sign at all. When it does, that is the most important date in your calendar. The house it enters is the…",
            "Its transits are read as tasks to meet. What you build under Saturn tends to last, and what you skip usually comes back. So look after that area on purpose rather than dread it: pick one steady habit there and keep it."
          ],
          "language": "en",
          "detail": "standard"
        }
      ]
    },
    {
      "id": "annual:annual-love",
      "title": "Annual Forecast: Love",
      "family": "annual",
      "text": [
        "Your year in love is read mainly from Venus, the planet of attraction and affection. The reading also follows planets moving through the houses (parts of your chart) that matter most for love and family. Those are the seventh for your…",
        "Venus moves quickly, so its mood shifts several times in your year. Each shift can open a short, pleasant window for romance, for growing closer to someone, and for enjoying good company.",
        "When Jupiter moves through these houses, or aspects them (sends its influence from another house), it supports long-term commitment. Proposals, marriage and settling into something steady tend to come more easily then. What you can do:…"
      ],
      "language": "en",
      "detail": "standard",
      "events": [
        {
          "kind": "ingress",
          "graha": "Jupiter",
          "starts": "2026-01-01",
          "ends": "2026-06-01",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-06-01T16:20-04:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Gemini",
          "natal_house": 10,
          "house_from_moon": 2,
          "result": "favorable",
          "why": [
            "karaka"
          ],
          "text": [
            "Jupiter, the planet of growth, wisdom and good advice, stays in one sign for about 12 months. So one sign change can be the biggest dated event of your year. The house it enters, the area of life that sign covers in your chart, is where…",
            "Because it moves slowly, it works as a background, not a single episode. That part of your life is easier for a year, though you often notice the ease more looking back. If Jupiter changes sign halfway through your year, the year really…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Ketu",
          "starts": "2026-01-01",
          "ends": "2026-11-25",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-11-25T07:15-05:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Leo",
          "natal_house": 12,
          "house_from_moon": 4,
          "result": "unfavorable",
          "why": [
            "house"
          ],
          "text": [
            "Ketu is the Moon's south node, the point exactly opposite Rahu. It stays in a sign for about 18 months and moves backward with Rahu. The house it enters is the area of life that sign covers in your chart. Detachment sets in there for you.…",
            "At the time this can feel like loss. Later, it often turns out to have been needed. The classical view is that Ketu clears away what is finished, though it rarely asks first. The house shows where this may happen, and the dates are below.…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Saturn",
          "starts": "2026-01-01",
          "ends": "2027-01-01",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2027-01-01T00:00-05:00",
          "started_before_the_year": true,
          "runs_past_the_year": true,
          "sign": "Pisces",
          "natal_house": 7,
          "house_from_moon": 11,
          "result": "favorable",
          "why": [
            "house"
          ],
          "text": [
            "Saturn, the planet of duty, patience and delay, stays in one sign for about two and a half years. So in most years it does not change sign at all. When it does, that is the most important date in your calendar. The house it enters is the…",
            "Its transits are read as tasks to meet. What you build under Saturn tends to last, and what you skip usually comes back. So look after that area on purpose rather than dread it: pick one steady habit there and keep it."
          ],
          "language": "en",
          "detail": "standard"
        }
      ]
    },
    {
      "id": "annual:annual-finance",
      "title": "Annual Forecast: Finance",
      "family": "annual",
      "text": [
        "Your money year is read mainly from two planets. Jupiter brings growth, and Venus rules comfort and the things you buy. The reading also follows the transits (planets moving through your chart). It looks at your money houses, the parts of…",
        "Jupiter stays in one sign for about a year. So when it moves into a new sign, it sets the pace for your money chances in the year ahead.",
        "The reading weighs what comes in against what goes out. Good transits through your eleventh house tend to bring gains. Transits through your twelfth house are a good time to spend on things that last. What you can do: plan big purchases…"
      ],
      "language": "en",
      "detail": "standard",
      "events": [
        {
          "kind": "ingress",
          "graha": "Jupiter",
          "starts": "2026-01-01",
          "ends": "2026-06-01",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-06-01T16:20-04:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Gemini",
          "natal_house": 10,
          "house_from_moon": 2,
          "result": "favorable",
          "why": [
            "karaka"
          ],
          "text": [
            "Jupiter, the planet of growth, wisdom and good advice, stays in one sign for about 12 months. So one sign change can be the biggest dated event of your year. The house it enters, the area of life that sign covers in your chart, is where…",
            "Because it moves slowly, it works as a background, not a single episode. That part of your life is easier for a year, though you often notice the ease more looking back. If Jupiter changes sign halfway through your year, the year really…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Ketu",
          "starts": "2026-01-01",
          "ends": "2026-11-25",
          "starts_at": "2026-01-01T00:00-05:00",
          "ends_at": "2026-11-25T07:15-05:00",
          "started_before_the_year": true,
          "runs_past_the_year": false,
          "sign": "Leo",
          "natal_house": 12,
          "house_from_moon": 4,
          "result": "unfavorable",
          "why": [
            "house"
          ],
          "text": [
            "Ketu is the Moon's south node, the point exactly opposite Rahu. It stays in a sign for about 18 months and moves backward with Rahu. The house it enters is the area of life that sign covers in your chart. Detachment sets in there for you.…",
            "At the time this can feel like loss. Later, it often turns out to have been needed. The classical view is that Ketu clears away what is finished, though it rarely asks first. The house shows where this may happen, and the dates are below.…"
          ],
          "language": "en",
          "detail": "standard"
        },
        {
          "kind": "ingress",
          "graha": "Jupiter",
          "starts": "2026-06-01",
          "ends": "2026-10-31",
          "starts_at": "2026-06-01T16:20-04:00",
          "ends_at": "2026-10-31T02:32-04:00",
          "started_before_the_year": false,
          "runs_past_the_year": false,
          "sign": "Cancer",
          "natal_house": 11,
          "house_from_moon": 3,
          "result": "unfavorable",
          "why": [
            "karaka",
            "house"
          ],
          "text": [
            "Jupiter, the planet of growth, wisdom and good advice, stays in one sign for about 12 months. So one sign change can be the biggest dated event of your year. The house it enters, the area of life that sign covers in your chart, is where…",
            "Because it moves slowly, it works as a background, not a single episode. That part of your life is easier for a year, though you often notice the ease more looking back. If Jupiter changes sign halfway through your year, the year really…"
          ],
          "language": "en",
          "detail": "standard"
        }
      ]
    }
  ],
  "events": [
    {
      "kind": "combust",
      "graha": "Mars",
      "starts": "2026-01-01",
      "ends": "2026-03-26",
      "starts_at": "2026-01-01T00:00-05:00",
      "ends_at": "2026-03-26T04:37-04:00",
      "started_before_the_year": true,
      "runs_past_the_year": false,
      "orb_degrees": {
        "direct": 17,
        "retrograde": 17
      },
      "reading": {
        "text": [
          "A planet is combust when it is close enough to the Sun to be lost in its glare. A combust Mars loses what it is most valued for. Courage, initiative and physical drive work through the Sun's authority rather than on their own. The…",
          "The orb is wide, 17 degrees from the Sun, so this can last for months. Treat it as a time to save your effort rather than spend it. Finish what you have already started before you take on anything new."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "kind": "combust",
      "graha": "Mercury",
      "starts": "2026-01-01",
      "ends": "2026-02-09",
      "starts_at": "2026-01-01T00:00-05:00",
      "ends_at": "2026-02-09T17:46-05:00",
      "started_before_the_year": true,
      "runs_past_the_year": false,
      "orb_degrees": {
        "direct": 14,
        "retrograde": 12
      },
      "reading": {
        "text": [
          "A planet is combust when it sits so close to the Sun that it is lost in the Sun's glare. Tradition reads it as weakened. Mercury is never far from the Sun, so it is combust for several stretches every year. Combustion is the most common…",
          "The orb used (how many degrees from the Sun count as too close) is given beside the dates. Sources differ, and two sound methods can disagree by weeks. In practice, put off anything that depends on clear wording during these stretches."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "kind": "combust",
      "graha": "Venus",
      "starts": "2026-01-01",
      "ends": "2026-02-17",
      "starts_at": "2026-01-01T00:00-05:00",
      "ends_at": "2026-02-17T04:38-05:00",
      "started_before_the_year": true,
      "runs_past_the_year": false,
      "orb_degrees": {
        "direct": 10,
        "retrograde": 8
      },
      "reading": {
        "text": [
          "Venus is combust when it is close enough to the Sun to lose its own light in the Sun's glare. That happens for a stretch or two in most years. For that time, what Venus rules (comfort, relationships, the taste for pleasure) is read as…",
          "The orb (how close to the Sun counts as combust) is given with the dates. For a retrograde Venus (one that seems to move backward), the orb is tighter than for a direct one. So the limit itself changes during the window. The classical…"
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "counts": {
    "events": 79
  },
  "note": "Ingresses and stations are facts and carry no convention. Combustion and conjunction windows depend on an ORB, sources differ, and each event states the orb it was judged by. The Moon is deliberately absent: it changes sign every two days…",
  "gaps": [],
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  }
}

The rule in John Doe's chart

Applies

The 2026 annual forecast for John Doe has a section called Annual Forecast: Career. Each event in it is placed twice: by the house of his birth chart and by the house counted from his Moon.

John Doe, born Aug 15, 1990, 10:30 AM, New York

Related glossary terms

Classification

Section
AN · Annual forecast
Kind
invention: Not from the classical texts; the API defines it so its output is consistent.
Feature
Transits and forecasts

Think this rule is wrong?

Tell us and give its ID, for example "AN-06 is wrong". We check every report and reply.

Report this rule

Where traditions differ, this rulebook states which choice the API follows. If you need a different school of astrology, talk to us. We will not switch it without telling you.

Related: Transits and forecasts, glossary, accuracy.

Astrology API

Check this rule against real output

Create a free test key and call the endpoint this rule belongs to. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer