Transits
Vedha in Vedic astrology
Vedha means obstruction, or blocking. In Vedic astrology, it is the rule that one moving planet can block the good effect of another. A planet passing a good house from the birth Moon loses that good effect when another planet sits in the paired house, its vedha point. In South Indian marriage matching, vedha also names pairs of nakshatras (birth stars) that should not be matched.
Updated
Vedha: how the API computes it
Vedha means blocking, and the API uses it in two places. The first is transits, where the planets are now. A planet in a good house from the birth Moon can have its good result blocked. That happens when another planet sits in the house that blocks it (TR-03).
The response names the blocking planet. TR-03 lists every pair, planet by planet. Take John Doe, whose birth Moon is in Taurus.
On October 1, 2026, the Moon itself passes Taurus. That is house 1 from his birth Moon, a good house for the Moon. Its vedha point is house 5, and the Sun sits there, in Virgo. So the API marks the Moon's good result as obstructed and names the Sun in obstructed_by.
Mars, in house 3, is in a good house too. Nothing sits in its vedha point, house 12, so its good result stands. Two pairs never block each other: Saturn with the Sun, and Mercury with the Moon (TR-04).
Rahu and Ketu are never blocked (TR-05). POST /v1/transits applies vedha for the single moment you ask about. A forecast over a period does not, on purpose, because the blocking planets move many times in a long period (TR-07).
The second place is matching. There, vedha is a separate pass-or-fail check on the two Moon nakshatras. Thirteen classical pairs of nakshatras are said to block each other, such as Ashwini with Jyeshtha.
Chitra has no partner and is always clear. Matching vedha carries no points (KM-08). POST /v1/matching and POST /v1/matching/nakshatra return it with the rest of the match.
Get it from the API
The Tajik annual chart (varshaphal) for one year. Here is the call to API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.
POST /v1/varshaphal
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/varshaphal?year=2026&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
-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,
"completed_years": 36,
"varsha_pravesh": {
"utc": "2026-08-15T19:54:24Z",
"local": "2026-08-15T15:54:24-04:00",
"offset_hours": -4,
"day": true,
"next": "2027-08-15T22:08:06-04:00"
},
"place": {
"latitude": 40.7128,
"longitude": -74.006,
"basis": "given place"
},
"chart": {
"ascendant": {
"name": "Ascendant",
"longitude": 234.2481086,
"sign": "Scorpio",
"sign_number": 8,
"degree_in_sign": 24.2481086,
"degree_dms": "24 : 14 : 53",
"house": 1,
"nakshatra": "Jyeshtha",
"nakshatra_lord": "Mercury",
"pada": 3,
"speed": 0,
"retrograde": false,
"combust": false,
"dignity": "n/a",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 8,
"bhaga": false,
"bhaga_degree": 11,
"bhaga_by_element": false,
"bhaga_degree_by_element": 7,
"sources_agree": true,
"orb_degrees": 1
}
},
"positions": [
{
"name": "Sun",
"longitude": 118.7753409,
"sign": "Cancer",
"sign_number": 4,
"degree_in_sign": 28.7753409,
"degree_dms": "28 : 46 : 31",
"house": 9,
"nakshatra": "Ashlesha",
"nakshatra_lord": "Mercury",
"pada": 4,
"speed": 0.9612311,
"retrograde": false,
"combust": false,
"dignity": "friend",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 9,
"bhaga": false,
"bhaga_degree": 8,
"bhaga_by_element": false,
"bhaga_degree_by_element": 7,
"sources_agree": true,
"orb_degrees": 1
}
},
{
"name": "Moon",
"longitude": 158.8777738,
"sign": "Virgo",
"sign_number": 6,
"degree_in_sign": 8.8777738,
"degree_dms": "08 : 52 : 40",
"house": 11,
"nakshatra": "Uttara Phalguni",
"nakshatra_lord": "Sun",
"pada": 4,
"speed": 13.3333426,
"retrograde": false,
"combust": false,
"dignity": "friend",
"vargottama": false,
"pushkara": {
"navamsa": true,
"navamsa_number": 3,
"bhaga": true,
"bhaga_degree": 9,
"bhaga_by_element": false,
"bhaga_degree_by_element": 14,
"sources_agree": false,
"orb_degrees": 1
}
},
{
"name": "Mars",
"longitude": 68.721385,
"sign": "Gemini",
"sign_number": 3,
"degree_in_sign": 8.721385,
"degree_dms": "08 : 43 : 17",
"house": 8,
"nakshatra": "Ardra",
"nakshatra_lord": "Rahu",
"pada": 1,
"speed": 0.6568859,
"retrograde": false,
"combust": false,
"dignity": "neutral",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 3,
"bhaga": false,
"bhaga_degree": 18,
"bhaga_by_element": false,
"bhaga_degree_by_element": 24,
"sources_agree": true,
"orb_degrees": 1
}
}
]
},
"muntha": {
"sign": "Virgo",
"sign_no": 6,
"lord": "Mercury",
"house": 11,
"result": "excellent",
"house_in_birth_chart": 1
},
"office_bearers": [
{
"office": "janma_lagna_lord",
"graha": "Mercury"
},
{
"office": "varsha_lagna_lord",
"graha": "Mars"
},
{
"office": "muntha_lord",
"graha": "Mercury"
}
],
"strengths": {
"pancha_vargeeya": {
"Sun": {
"total": 8.54,
"band": "ordinary",
"parts": {
"kshetra": 15,
"hadda": 3.75,
"drekkana": 5,
"navamsa": 2.5,
"uchcha": 7.914
},
"lords": {
"kshetra": "Moon",
"hadda": "Saturn",
"drekkana": "Jupiter",
"navamsa": "Jupiter"
}
},
"Moon": {
"total": 5.57,
"band": "ordinary",
"parts": {
"kshetra": 7.5,
"hadda": 3.75,
"drekkana": 2.5,
"navamsa": 2.5,
"uchcha": 6.014
},
"lords": {
"kshetra": "Mercury",
"hadda": "Venus",
"drekkana": "Mercury",
"navamsa": "Jupiter"
}
},
"Mars": {
"total": 6.37,
"band": "ordinary",
"parts": {
"kshetra": 7.5,
"hadda": 7.5,
"drekkana": 2.5,
"navamsa": 2.5,
"uchcha": 5.475
},
"lords": {
"kshetra": "Mercury",
"hadda": "Jupiter",
"drekkana": "Mercury",
"navamsa": "Jupiter"
}
},
"Mercury": {
"total": 9.94,
"band": "ordinary",
"parts": {
"kshetra": 7.5,
"hadda": 15,
"drekkana": 2.5,
"navamsa": 1.25,
"uchcha": 13.511
},
"lords": {
"kshetra": "Moon",
"hadda": "Mercury",
"drekkana": "Mars",
"navamsa": "Mars"
}
},
"Jupiter": {
"total": 11.26,
"band": "powerful",
"parts": {
"kshetra": 15,
"hadda": 3.75,
"drekkana": 5,
"navamsa": 2.5,
"uchcha": 18.778
},
"lords": {
"kshetra": "Moon",
"hadda": "Mercury",
"drekkana": "Mars",
"navamsa": "Mars"
}
},
"Venus": {
"total": 10.34,
"band": "powerful",
"parts": {
"kshetra": 15,
"hadda": 15,
"drekkana": 5,
"navamsa": 5,
"uchcha": 1.372
},
"lords": {
"kshetra": "Mercury",
"hadda": "Venus",
"drekkana": "Saturn",
"navamsa": "Venus"
}
},
"Saturn": {
"total": 5.52,
"band": "ordinary",
"parts": {
"kshetra": 7.5,
"hadda": 3.75,
"drekkana": 2.5,
"navamsa": 5,
"uchcha": 3.313
},
"lords": {
"kshetra": "Jupiter",
"hadda": "Mars",
"drekkana": "Mars",
"navamsa": "Saturn"
}
}
},
"harsha": {
"Sun": {
"total": 10,
"band": "average",
"met": [
"house",
"day_or_night"
]
},
"Moon": {
"total": 0,
"band": "nil",
"met": []
},
"Mars": {
"total": 5,
"band": "little",
"met": [
"day_or_night"
]
},
"Mercury": {
"total": 5,
"band": "little",
"met": [
"quarter"
]
},
"Jupiter": {
"total": 10,
"band": "average",
"met": [
"own_or_exalted",
"day_or_night"
]
},
"Venus": {
"total": 0,
"band": "nil",
"met": []
},
"Saturn": {
"total": 0,
"band": "nil",
"met": []
}
}
},
"year_lord": {
"graha": "Mercury",
"aspects_lagna": true,
"basis": "strongest_aspecting",
"munthesha": "Mercury",
"min_strength": 5,
"filters": [
"aspects_lagna: a Tajik aspect (1st, 3rd, 4th, 5th, 7th, 9th, 10th or 11th) on the annual lagna",
"not_moon: the Moon is never the year lord",
"min_strength: at least 5 of 20 vishwa of pancha-vargeeya bala"
],
"ranked": [
{
"graha": "Mercury",
"strength": 9.94,
"aspects_lagna": true,
"excluded": null,
"chosen": true
},
{
"graha": "Mars",
"strength": 6.37,
"aspects_lagna": false,
"excluded": "no_aspect",
"chosen": false
},
{
"graha": "Moon",
"strength": 5.57,
"aspects_lagna": true,
"excluded": "moon",
"chosen": false
}
],
"disputed": []
},
"sahams": [
{
"name": "punya",
"longitude": 304.3505,
"sign": "Aquarius",
"degree_dms": "04 : 21 : 02",
"lord": "Saturn",
"house": 4,
"formula": "Moon - Sun + Asc",
"plus_30": true,
"sensitive": false,
"reading": {
"key": "saham:punya",
"text": [
"The point of fortune and good deeds falls in your 4th house this year."
],
"language": "en",
"detail": "standard"
}
},
{
"name": "vidya",
"longitude": 194.1457,
"sign": "Libra",
"degree_dms": "14 : 08 : 44",
"lord": "Venus",
"house": 12,
"formula": "Sun - Moon + Asc",
"plus_30": false,
"sensitive": false,
"reading": {
"key": "saham:vidya",
"text": [
"The point of learning and education falls in your 12th house this year."
],
"language": "en",
"detail": "standard"
}
},
{
"name": "yashas",
"longitude": 65.8945,
"sign": "Gemini",
"degree_dms": "05 : 53 : 40",
"lord": "Mercury",
"house": 8,
"formula": "Jupiter - punya + Asc",
"plus_30": true,
"sensitive": false,
"reading": {
"key": "saham:yashas",
"text": [
"The point of fame and reputation falls in your 8th house this year."
],
"language": "en",
"detail": "standard"
}
}
],
"disputed_sahams": [
{
"name": "roga",
"sources_agree": false,
"sensitive": true,
"convention_a": {
"longitude": 339.6184,
"sign": "Pisces",
"degree_dms": "09 : 37 : 06",
"house": 5,
"formula": "Asc - Moon + Asc",
"plus_30": true,
"reading": {
"key": "saham:roga",
"text": [
"The point of illness falls in your 5th house this year. It shows where to look after your health, but it is not a prediction."
],
"language": "en",
"detail": "standard"
}
},
"convention_b": {
"longitude": 309.6184,
"sign": "Aquarius",
"degree_dms": "09 : 37 : 06",
"house": 4,
"formula": "Asc - Moon + Asc",
"plus_30": false,
"reading": {
"key": "saham:roga",
"text": [
"The point of illness falls in your 4th house this year. It shows where to look after your health, but it is not a prediction."
],
"language": "en",
"detail": "standard"
}
}
},
{
"name": "paradara",
"sources_agree": true,
"sensitive": true,
"convention_a": {
"longitude": 310.1211,
"sign": "Aquarius",
"degree_dms": "10 : 07 : 16",
"house": 4,
"formula": "Venus - Sun + Asc",
"plus_30": true,
"reading": {
"key": "saham:paradara",
"text": [
"The traditional point of affairs outside marriage falls in your 4th house this year. This point is read in the old texts and is not a prediction about anyone."
],
"language": "en",
"detail": "standard"
}
},
"convention_b": {
"longitude": 310.1211,
"sign": "Aquarius",
"degree_dms": "10 : 07 : 16",
"house": 4,
"formula": "Venus - Sun + Asc",
"plus_30": true,
"reading": {
"key": "saham:paradara",
"text": [
"The traditional point of affairs outside marriage falls in your 4th house this year. This point is read in the old texts and is not a prediction about anyone."
],
"language": "en",
"detail": "standard"
}
}
},
{
"name": "vivaha",
"sources_agree": true,
"sensitive": false,
"convention_a": {
"longitude": 78.7157,
"sign": "Gemini",
"degree_dms": "18 : 42 : 56",
"house": 8,
"formula": "Venus - Saturn + Asc",
"plus_30": true,
"reading": {
"key": "saham:vivaha",
"text": [
"The point of marriage falls in your 8th house this year."
],
"language": "en",
"detail": "standard"
}
},
"convention_b": {
"longitude": 78.7157,
"sign": "Gemini",
"degree_dms": "18 : 42 : 56",
"house": 8,
"formula": "Venus - Saturn + Asc",
"plus_30": true,
"reading": {
"key": "saham:vivaha",
"text": [
"The point of marriage falls in your 8th house this year."
],
"language": "en",
"detail": "standard"
}
}
}
],
"mudda_dasha": [
{
"lord": "Mars",
"start": {
"utc": "2026-08-15T19:54:24Z",
"local": "2026-08-15T15:54:24-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-09-06T02:54:24Z",
"local": "2026-09-05T22:54:24-04:00",
"offset_hours": -4
},
"days": 21.29,
"house": 8,
"reading": {
"key": "period:Mars+house:8",
"text": [
"This Mars period brings energy and drive, with some risk of haste, injury or arguments. In your yearly chart it sits in the 8th house. So its effect falls mainly on sudden changes, health and hidden matters."
],
"language": "en",
"detail": "standard"
}
},
{
"lord": "Rahu",
"start": {
"utc": "2026-09-06T02:54:24Z",
"local": "2026-09-05T22:54:24-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-10-30T20:54:24Z",
"local": "2026-10-30T16:54:24-04:00",
"offset_hours": -4
},
"days": 54.75,
"house": 4,
"reading": {
"key": "period:Rahu+house:4",
"text": [
"This Rahu period can bring sudden ambitions, new contacts and some confusion, so check facts before you act. In your yearly chart it sits in the 4th house. So its effect falls mainly on home, mother, property and peace of mind."
],
"language": "en",
"detail": "standard"
}
},
{
"lord": "Jupiter",
"start": {
"utc": "2026-10-30T20:54:24Z",
"local": "2026-10-30T16:54:24-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-12-18T12:54:24Z",
"local": "2026-12-18T07:54:24-05:00",
"offset_hours": -5
},
"days": 48.67,
"house": 9,
"reading": {
"key": "period:Jupiter+house:9",
"text": [
"This Jupiter period tends to bring growth, good advice, learning and family happiness. In your yearly chart it sits in the 9th house. So its effect falls mainly on luck, faith, teachers and long journeys."
],
"language": "en",
"detail": "standard"
}
}
],
"mudda_dasha_solar": [
{
"lord": "Mars",
"start": {
"utc": "2026-08-13T19:03:36Z",
"local": "2026-08-13T15:03:36-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-09-04T13:44:35Z",
"local": "2026-09-04T09:44:34-04:00",
"offset_hours": -4
},
"sun_arc": 21,
"balance_elapsed": 0.093128,
"house": 8,
"reading": {
"key": "period:Mars+house:8",
"text": [
"This Mars period brings energy and drive, with some risk of haste, injury or arguments. In your yearly chart it sits in the 8th house. So its effect falls mainly on sudden changes, health and hidden matters."
],
"language": "en",
"detail": "standard"
}
},
{
"lord": "Rahu",
"start": {
"utc": "2026-09-04T13:44:35Z",
"local": "2026-09-04T09:44:34-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-10-29T11:23:52Z",
"local": "2026-10-29T07:23:51-04:00",
"offset_hours": -4
},
"sun_arc": 54,
"house": 4,
"reading": {
"key": "period:Rahu+house:4",
"text": [
"This Rahu period can bring sudden ambitions, new contacts and some confusion, so check facts before you act. In your yearly chart it sits in the 4th house. So its effect falls mainly on home, mother, property and peace of mind."
],
"language": "en",
"detail": "standard"
}
},
{
"lord": "Jupiter",
"start": {
"utc": "2026-10-29T11:23:52Z",
"local": "2026-10-29T07:23:51-04:00",
"offset_hours": -4
},
"end": {
"utc": "2026-12-16T00:39:47Z",
"local": "2026-12-15T19:39:47-05:00",
"offset_hours": -5
},
"sun_arc": 48,
"house": 9,
"reading": {
"key": "period:Jupiter+house:9",
"text": [
"This Jupiter period tends to bring growth, good advice, learning and family happiness. In your yearly chart it sits in the 9th house. So its effect falls mainly on luck, faith, teachers and long journeys."
],
"language": "en",
"detail": "standard"
}
}
],
"mudda_conventions": {
"mudda_dasha": "365 days from the varsha pravesh, no birth balance",
"mudda_dasha_solar": "the Sun's arc, 360 degrees a year, entered with the birth nakshatra balance, so it begins before the varsha pravesh",
"sources_agree": false
},
"birth_nakshatra": "Mrigashira",
"tajaka_yogas": {
"yogas": [
{
"yoga": "ithasala",
"planets": [
"Moon",
"Mercury"
],
"aspect": "sextile",
"aspect_angle": 60,
"orb": 9.5,
"separation": 7.7185,
"motion": "applying",
"purna": false,
"retrograde": [],
"nature": "helps",
"reading": {
"key": "tajaka:ithasala",
"text": [
"The Moon is moving toward a close link with Mercury this year. Plans tied to these two planets tend to come together with steady effort."
],
"language": "en",
"detail": "standard"
}
},
{
"yoga": "ithasala",
"planets": [
"Moon",
"Jupiter"
],
"aspect": "sextile",
"aspect_angle": 60,
"orb": 10.5,
"separation": 7.1191,
"motion": "applying",
"purna": false,
"retrograde": [],
"nature": "helps",
"reading": {
"key": "tajaka:ithasala",
"text": [
"The Moon is moving toward a close link with Jupiter this year. Plans tied to these two planets tend to come together with steady effort."
],
"language": "en",
"detail": "standard"
}
},
{
"yoga": "ithasala",
"planets": [
"Moon",
"Venus"
],
"aspect": "conjunction",
"aspect_angle": 0,
"orb": 9.5,
"separation": 5.7705,
"motion": "applying",
"purna": false,
"retrograde": [],
"nature": "helps",
"reading": {
"key": "tajaka:ithasala",
"text": [
"The Moon is moving toward a close link with Venus this year. Plans tied to these two planets tend to come together with steady effort."
],
"language": "en",
"detail": "standard"
}
}
],
"counts": {
"ithasala": 7,
"ishrafa": 5,
"nakta": 3,
"yamaya": 0,
"manau": 6,
"kamboola": 4,
"khallasara": 0,
"radda": 5,
"duhphali_kuttha": 2,
"ikkavala": 0,
"induvara": 0,
"kuttha": 0,
"durapha": 0,
"gairi_kamboola": 0,
"tambira": 0,
"dutthottha_davira": 0
},
"deeptamsha": {
"Sun": 15,
"Moon": 12,
"Mars": 8,
"Mercury": 7,
"Jupiter": 9,
"Venus": 7,
"Saturn": 9
},
"orb_rule": "The orb of a pair is the mean of the two deeptamshas; a meeting is active when the separation from the exact Tajik angle (0, 60, 90, 120, 180) is within it.",
"motion_rule": "Applying when the gap to exact is shrinking under the two grahas' signed daily motions; a retrograde graha moves backwards, which reverses its part in the test.",
"not_computed": [],
"sources": "Tajika Neelakanthi, Samjna Tantra, as given in K. S. Charak, A Text Book of Varshaphala, ch. on the Tajika yogas; the astrologer's ruling N-18 (2026-10-31, owner-relayed)",
"review": "awaiting the astrologer (VP-13 to VP-15)"
},
"not_computed": [
"mitra (friends), sneha (love), putra (children), vyapara (business), karyasiddhi and the vocation saham: an outside report's values match no classical formula, so none is shipped until the astrologer settles which is meant",
"mrityu, paradesa, artha and labha: they read house cusps, and this service uses whole-sign houses with no quadrant cusps"
],
"meta": {
"ayanamsa": "lahiri",
"ayanamsa_value": 24.22898,
"ephemeris": "JPL DE440s",
"node": "true",
"natal_sun": 118.7753409
},
"masa_pravesh": [
{
"month": 1,
"utc": "2026-08-15T19:54:24Z",
"local": "2026-08-15T15:54:24-04:00",
"offset_hours": -4,
"sun_longitude": 118.775341,
"sun_sign": "Cancer",
"day": true,
"lagna": {
"sign": "Scorpio",
"sign_number": 8,
"longitude": 234.248109,
"degree_dms": "24 : 14 : 53"
}
},
{
"month": 2,
"utc": "2026-09-15T20:14:26Z",
"local": "2026-09-15T16:14:25-04:00",
"offset_hours": -4,
"sun_longitude": 148.775341,
"sun_sign": "Leo",
"day": true,
"lagna": {
"sign": "Sagittarius",
"sign_number": 9,
"longitude": 268.528609,
"degree_dms": "28 : 31 : 43"
}
},
{
"month": 3,
"utc": "2026-10-16T08:43:53Z",
"local": "2026-10-16T04:43:53-04:00",
"offset_hours": -4,
"sun_longitude": 178.775341,
"sun_sign": "Virgo",
"day": false,
"lagna": {
"sign": "Leo",
"sign_number": 5,
"longitude": 149.301039,
"degree_dms": "29 : 18 : 04"
}
}
],
"tri_pataki": {
"running_year": 37,
"methods": {
"three_tier": {
"source": "K. S. Charak, A Textbook of Varshaphala: Moon 9, Mars and the nodes 6, the rest 4",
"placements": [
{
"graha": "Sun",
"natal_sign": "Cancer",
"sign": "Cancer",
"cycle": 4,
"count": 1,
"direction": "forward",
"house": 9
},
{
"graha": "Moon",
"natal_sign": "Taurus",
"sign": "Taurus",
"cycle": 9,
"count": 1,
"direction": "forward",
"house": 7
},
{
"graha": "Mars",
"natal_sign": "Aries",
"sign": "Aries",
"cycle": 6,
"count": 1,
"direction": "forward",
"house": 6
}
],
"points": [
{
"house": 1,
"sign": "Scorpio",
"grahas": [],
"vedha_from_houses": [
4,
7,
10
]
},
{
"house": 2,
"sign": "Sagittarius",
"grahas": [
"Saturn"
],
"vedha_from_houses": [
3,
6,
9
]
},
{
"house": 3,
"sign": "Capricorn",
"grahas": [
"Rahu"
],
"vedha_from_houses": [
2,
8,
11
]
}
],
"vedha": {
"moon": {
"house": 7,
"same_point_counts": true,
"sign": "Taurus",
"grahas": [
"Mercury"
],
"benefics": [
"Mercury"
],
"malefics": [],
"same_point": [],
"evaluation": "primary"
},
"lagna": {
"house": 1,
"same_point_counts": true,
"sign": "Scorpio",
"grahas": [
"Mercury"
],
"benefics": [
"Mercury"
],
"malefics": [],
"same_point": [],
"evaluation": "secondary"
}
}
},
"neelakanthi": {
"source": "Tajika Neelakanthi: Mars counted with the four-year group",
"placements": [
{
"graha": "Sun",
"natal_sign": "Cancer",
"sign": "Cancer",
"cycle": 4,
"count": 1,
"direction": "forward",
"house": 9
},
{
"graha": "Moon",
"natal_sign": "Taurus",
"sign": "Taurus",
"cycle": 9,
"count": 1,
"direction": "forward",
"house": 7
},
{
"graha": "Mars",
"natal_sign": "Aries",
"sign": "Aries",
"cycle": 4,
"count": 1,
"direction": "forward",
"house": 6
}
],
"points": [
{
"house": 1,
"sign": "Scorpio",
"grahas": [],
"vedha_from_houses": [
4,
7,
10
]
},
{
"house": 2,
"sign": "Sagittarius",
"grahas": [
"Saturn"
],
"vedha_from_houses": [
3,
6,
9
]
},
{
"house": 3,
"sign": "Capricorn",
"grahas": [
"Rahu"
],
"vedha_from_houses": [
2,
8,
11
]
}
],
"vedha": {
"moon": {
"house": 7,
"same_point_counts": true,
"sign": "Taurus",
"grahas": [
"Mercury"
],
"benefics": [
"Mercury"
],
"malefics": [],
"same_point": [],
"evaluation": "primary"
},
"lagna": {
"house": 1,
"same_point_counts": true,
"sign": "Scorpio",
"grahas": [
"Mercury"
],
"benefics": [
"Mercury"
],
"malefics": [],
"same_point": [],
"evaluation": "secondary"
}
}
}
},
"sources_agree": true,
"differ_on": [],
"basis": "Natal signs moved on by the running year (completed years + 1): the remainder on dividing by each graha's cycle, zero read as the cycle, counted inclusively from the natal sign; the nodes count backwards. The annual lagna sits on the…",
"not_claimed": [
"No verdict on the year: the texts that teach this chakra say it must be read with the birth and annual charts and the dasha, and is not consistent alone",
"A graha on a target's own point is vedha on it (a direct hit), and is also named in same_point",
"The Moon is the primary target, as standard practice reads the chakra; the lagna is a secondary evaluation some astrologers use"
],
"review": "settled by the astrologer 2026-10-30 and 2026-10-31 (VP-12): a target's own point is vedha, and the Moon is target only"
},
"reading": {
"framing": {
"key": "framing",
"text": [
"Your varshaphal is a chart for one year of your life. The chart is cast for the moment the Sun returns to the exact place it held when you were born. It shows the mood of the coming year: which part of life comes forward and which planet…"
],
"language": "en",
"detail": "standard"
},
"muntha": {
"key": "muntha:11",
"text": [
"Muntha is in the 11th house this year. Gains, friends and wishes coming true are in focus. Friends and networks tend to help you."
],
"language": "en",
"detail": "standard"
},
"year_lord": {
"key": "year_lord:Mercury",
"text": [
"Mercury rules your year. Learning, communication, trade and quick thinking are in focus. It suits study, writing and business, if you avoid scattering your effort."
],
"language": "en",
"detail": "standard"
},
"notes": [
{
"key": "note:mudda_conventions",
"text": [
"Astrology software differs on how to measure the year for these periods. One method counts 365 days from your yearly chart, and the other follows the Sun and starts a little earlier. Both are shown."
],
"language": "en",
"detail": "standard"
},
{
"key": "note:disputed_sahams",
"text": [
"For these points, two well-known programs use different rules, so both answers are shown."
],
"language": "en",
"detail": "standard"
},
{
"key": "note:tendency",
"text": [
"Everything here describes tendencies to work with, not fixed events."
],
"language": "en",
"detail": "standard"
}
]
},
"gaps": []
}Where the API returns it
| POST | /v1/varshaphal | The Tajik annual chart (varshaphal) for one year |
| POST | /v1/transits | Current transits read against a chart |
| POST | /v1/transits/forecast | Upcoming transit periods for a chart |
| POST | /v1/matching | Marriage compatibility score (ashtakoot, 36 points) |
| POST | /v1/matching/nakshatra | Compatibility score from two nakshatras, no birth charts |
| POST | /v1/reading/daily | Daily reading for a chart |
What the API reference says
Each line is quoted from the reference page of the endpoint named above it.
- POST /v1/varshaphal · The Tajik annual chart (varshaphal) for one yearEach natal sign moves on by the running year; the result says which grahas pierce (vedha) the Moon and the lagna.
- POST /v1/transits/forecast · Upcoming transit periods for a chartVedha is not applied to future periods, on purpose.
- POST /v1/matching · Marriage compatibility score (ashtakoot, 36 points)Rajju, vedha and the Mars (mangal) comparison carry no points.
Feature page: Transits and forecasts. Who uses it: Publishers and media. The classical rules the API follows are in the rulebook.
How we check the numbers
Every value here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test.
Related terms
From the blog
Astrology API
Get these values from the API
Create a free test key and call any endpoint on this page. 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.
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