OL · Theme forecasts
OL-02: Transits and periods, never ranked together
Endpoints that apply this rule
Each call returns the rule it used, so you can match a result to OL-02.
| POST | /v1/forecast/{theme} | Love, career or wealth forecast |
| POST | /v1/forecast/couple/{theme} | Love, career or wealth forecast for a couple |
Call an endpoint that applies it
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"}'{
"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
A love forecast for John Doe, from Oct 1 to Dec 31, 2026, is read from houses 7, 2 and 12 and the planets Venus and Jupiter. It returns two dated lists, transits and dasha periods, and never ranks them against each other.
John Doe, born Aug 15, 1990, 10:30 AM, New York
Related glossary terms
Classification
- Section
- OL · Theme forecasts
- Kind
- classical: The major traditions of Vedic astrology agree on this rule.
- Feature
- Readings and reports
Think this rule is wrong?
Tell us and give its ID, for example "OL-02 is wrong". We check every report and reply.
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
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer