New Numerology API

LP · Life prediction topics

LP-03: A life topic is built from the chart

A life topic reading is built from this chart's own rules, not taken from a stored paragraph for the rising sign.

See all 4 rules in this section

© API for Astrology (apiforastrology.com). "A rule page". All rights reserved. Not to be copied or reused.LP-03invention ruleA life topic is built from thechartLife prediction topicsFires for John Doe

Endpoints that apply this rule

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

POST/v1/forecast/{theme}Love, career or wealth forecast
POST/v1/summaryPlain-language summary of 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/love

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/forecast/love?from=2026-10-01&to=2026-12-31" \
  -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
{
  "theme": "love",
  "focus": "love-and-marriage",
  "read_from": "the seventh house and its lord, the second, and Venus",
  "houses": [
    7,
    2,
    12
  ],
  "lords": [
    7,
    2
  ],
  "karakas": [
    "Venus",
    "Jupiter"
  ],
  "window": {
    "from": "2026-10-01",
    "to": "2026-12-31"
  },
  "not_ranked": "a transit and a mahadasha are not on one scale -- one lasts weeks and the other twenty years. They are two lists with their dates, and no number puts them in order",
  "framing": {
    "text": [
      "**This is your love and marriage forecast for the time ahead.** It reads your 7th, 2nd and 12th houses, the parts of your chart for marriage and close bonds. It also follows the planets that stand for love in your chart (Venus and Jupiter).",
      "Two clocks run at once. **Transits**, the planets moving through your chart now, are the weather: they come and go in weeks or months. Your **running mahadasha and antardasha** are the long period and the shorter sub-period you are living…",
      "A transit can only bring what your running period allows. Read the two together to see when bigger steps in love are more likely. You can also see how to use the quieter stretches. What you can do: save the big steps, such as a proposal or…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "transits": [
    {
      "graha": "Mercury",
      "house_from_moon": 6,
      "sign": "Libra",
      "starts": "2026-10-01T00:00:00",
      "ends": "2026-12-02T06:57:31",
      "entry_known": false,
      "exit_known": true,
      "resumes_visit": false,
      "result": "favorable",
      "vedha_house": 9,
      "bindus": 6,
      "strength": "strong",
      "natal_house": 2,
      "why": [
        "crossing your 2nd house, counted from your lagna"
      ],
      "transit_reading_id": "transit:Mercury:6",
      "reading": {
        "text": [
          "Mercury is crossing your 2nd house, the house of family and home life. Until December 2, family tends to back your relationship, so it is a good time for talks at home."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "graha": "Jupiter",
      "house_from_moon": 3,
      "sign": "Cancer",
      "starts": "2026-10-01T00:00:00",
      "ends": "2026-10-31T02:32:49",
      "entry_known": false,
      "exit_known": true,
      "resumes_visit": false,
      "result": "unfavorable",
      "vedha_house": null,
      "bindus": 4,
      "strength": "moderate",
      "natal_house": 11,
      "why": [
        "karaka for this theme"
      ],
      "transit_reading_id": "transit:Jupiter:3",
      "reading": {
        "text": [
          "Jupiter is a natural sign of love in your chart, so its move matters for you. Until October 31, feelings can run hot and cold, so be patient with each other."
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "graha": "Venus",
      "house_from_moon": 6,
      "sign": "Libra",
      "starts": "2026-10-01T00:00:00",
      "ends": "2026-11-05T14:34:20",
      "entry_known": false,
      "exit_known": true,
      "resumes_visit": false,
      "result": "unfavorable",
      "vedha_house": null,
      "bindus": 4,
      "strength": "moderate",
      "natal_house": 2,
      "why": [
        "karaka for this theme",
        "crossing your 2nd house, counted from your lagna"
      ],
      "transit_reading_id": "transit:Venus:6",
      "reading": {
        "text": [
          "Venus is crossing your 2nd house, the house of family and home life. Until November 5, family talks can get heated, so choose your words with care.",
          "Venus is a natural sign of love in your chart, so its move matters for you. Until November 5, feelings can run hot and cold, so be patient with each other."
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "clashes": [
    {
      "subject": "house",
      "house": 2,
      "from": "2026-10-01T00:00:00",
      "to": "2026-11-05T14:34:20",
      "favorable": "Mercury",
      "unfavorable": "Venus",
      "reading": {
        "text": [
          "**October 1, 2026 to November 5, 2026:** Mercury and Venus both cross your 2nd house at the same time, and they pull opposite ways. You may feel some of each, with help coming beside setbacks. Neither one cancels the other, so take the…"
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "subject": "house",
      "house": 2,
      "from": "2026-10-17T10:21:43",
      "to": "2026-11-05T14:34:20",
      "favorable": "Sun",
      "unfavorable": "Venus",
      "reading": {
        "text": [
          "**October 17, 2026 to November 5, 2026:** Sun and Venus both cross your 2nd house at the same time, and they pull opposite ways. You may feel some of each, with help coming beside setbacks. Neither one cancels the other, so take the help…"
        ],
        "language": "en",
        "detail": "standard"
      }
    },
    {
      "subject": "karaka",
      "house": null,
      "from": "2026-11-05T14:34:20",
      "to": "2026-11-22T06:51:08",
      "favorable": "Venus",
      "unfavorable": "Jupiter",
      "reading": {
        "text": [
          "**November 5, 2026 to November 22, 2026:** Venus and Jupiter, the planets that stand for this part of life in your chart, pull opposite ways at the same time. Good days and harder days can come close together, so judge the stretch as a…"
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "periods": [
    {
      "level": "mahadasha",
      "within": null,
      "lord": "Jupiter",
      "lord_name": "Jupiter",
      "starts": "2014-12-20",
      "ends": "2030-12-20",
      "years": 16,
      "owns_theme_houses": [
        7
      ],
      "occupies_house": null,
      "is_karaka": true,
      "why": [
        "rules your 7th house",
        "karaka for this theme"
      ],
      "counts": 2,
      "reading": {
        "text": [
          "Jupiter stands for wisdom, growth and good guidance. So a Jupiter period puts four things at the center: learning, faith, children and steady growth in money. When it is your major period, it lasts 16 years. Doors tend to open through…",
          "By nature it is the most protective of the periods. How much of that you feel depends on how Jupiter stands in your chart, and the reading below shows this. At its best, things usually work out: help turns up, and mistakes are forgiven…",
          "It rewards study, teaching, giving advice and anything that grows slowly. For health, watch the liver, your weight and the blood. What helps: keep some discipline while life is easy, such as a regular exercise habit and a budget that still…"
        ],
        "language": "en",
        "detail": "standard"
      }
    }
  ],
  "transits_reading": {
    "text": [
      "**10 transits** touch this part of your life in the window you chose. A transit is a planet moving through one of your houses. Each one is counted two ways. The house from your birth Moon shows whether it helps or strains. The house from…",
      "Each transit is read by the house it wakes up and the houses its planet rules. That shows you when doors may open and when it pays to wait. It means the most when you read it next to your running dasha. What you can do: mark the dates…"
    ],
    "language": "en",
    "detail": "standard"
  },
  "periods_reading": {
    "text": [
      "**One dasha period** in your forecast window is tied to this part of your life. A dasha is a long planetary period. While this one runs, it tends to bring this area to the front.",
      "The entry below says why its planet was chosen. A transit can only add to what your running period allows. What you can do: use this period on purpose, and set one clear goal for this area before it begins or early in it."
    ],
    "language": "en",
    "detail": "standard"
  },
  "gaps": [],
  "language": "en",
  "detail": "standard",
  "omitted": [
    {
      "graha": "Moon",
      "reason": "changes house 41 times in this window, more than the 14 a timeline lists. Narrow the window, or read it from /v1/transits/ingresses/Moon."
    }
  ],
  "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

John Doe's chart summary reads his work from house 10, whose lord is Mercury, and gives the verdict mixed. Money is read from house 2, whose lord is Venus.

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

Related glossary terms

Classification

Section
LP · Life prediction topics
Kind
invention: Not from the classical texts; the API defines it so its output is consistent.
Feature
Readings and reports

Think this rule is wrong?

Tell us and give its ID, for example "LP-03 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: Readings and reports, 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