POST /v1/prashna · 3 credits
Praśna (horary): a question, a deal, or a horary number
The chart of the moment and place a question is asked, read on classical praśna rules, no model. Always: the praśna lagna and its lord, the Moon, the house of the matter asked about, the classical rules that apply (recovery from illness for a health question; recovery of a lost article when the question names one), and the further classical rules that held on this chart, each with its reference and the chart facts that made it hold. With `deal`: the deal praśna — significators (lagna lord = you, 7th = the other side, 10th = the undertaking, 11th = gain), their planetary contacts, the grounds for and against, and an ordered verdict (perfects, perfects after obstacles, contested, delayed, delayed and contested, not perfected); add `birthData` for the natal commitment calendar beside it, never blended with it. With `horaryNumber` (1–249): the horary table — house cusps for the moment that number rises, planets at the moment of judgment, their ruling lords, and the ruling planets; no judgment is asserted from it. Rules about caste, prenatal sex or death timing are withheld and counted.
Request (works as-is with a sandbox key):
curl -X POST https://www.astronest.ai/api/developer/v1/prashna \
-H "Authorization: Bearer astro_sandbox_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"place":{"latitude":28.6139,"longitude":77.209,"timezone":"Asia/Kolkata","label":"New Delhi"},"askedAt":"2026-10-14T10:30:00+05:30","question":"Will the supply contract with Northwind be signed?","deal":{"label":"Northwind supply contract","kind":"contract","signingDate":"2026-11-02"},"birthData":{"date":"1990-05-12","time":"14:35","timezone":"Asia/Kolkata","latitude":28.6139,"longitude":77.209},"horaryNumber":108}'Response (sandbox sample, long lists shortened):
{
"requestId": "sandbox",
"engineVersion": "astro-nest-v1-public",
"timestamp": "2026-10-15T03:34:14.464Z",
"usage": {
"units_charged": 0,
"remaining_credits": 0
},
"disclaimer": "Symbolic interpretation only. Not medical, legal, financial, or psychological advice.",
"domain": "prashna",
"askedAt": "2026-10-14T05:00:00.000Z",
"place": {
"latitude": 28.6139,
"longitude": 77.209,
"timezone": "Asia/Kolkata",
"label": "New Delhi"
},
"question": "Will the supply contract with Northwind be signed?",
"prashna": {
"lagna": "Scorpio",
"lagnaLord": "Mars",
"moonHouse": 1,
"matterHouse": 7,
"domain": "partnerships",
"findings": [
{
"quote": null,
"source": null,
"holds": null,
"because": "Praśna lagna Scorpio, its lord Mars in Cancer, the 9th. The Moon — the querent's own mind at the moment of asking — is in the 1st."
},
{
"quote": null,
"source": null,
"holds": null,
"because": "The matter asked about is read from the 7th of the praśna chart (Taurus), ruled by Venus in Libra, the 12th (domicile)."
}
],
"bookRules": {
"held": [
{
"principle": "Ketu in the Lagna, 4th, or 10th house and Mandi in a Kendra can influence the native's life significantly.",
"source": "Advanced Prashna",
"direction": "mixed",
"because": [
"Ketu in the 10th",
"Moon in the 1st"
],
"scope": "universal"
},
{
"principle": "The placement of the ascendant lord in the 5th or 9th house indicates greater luck and good fortune, particularly when placed in the 9th house.",
"source": "KP Horary Houses 8 and 3",
"direction": "support",
"because": [
"Mars in the 9th"
],
"scope": "universal"
},
{
"principle": "Malefic planets in the 9th house cause a reversal of luck for the subject, while in the 3rd house they cause a reversal of luck for the opposition.",
"source": "Advanced Prashna",
"direction": "challenge",
"because": [
"Mars in the 9th"
],
"scope": "universal"
},
"… 1 more"
],
"considered": 26,
"withheld": 7
}
},
"deal": {
"deal": {
"label": "Northwind supply contract",
"kind": "contract"
},
"askedAtIso": "2026-10-14T05:00:00.000Z",
"placeLabel": "New Delhi",
"lagna": {
"sign": "Scorpio",
"degree": 19.14,
"quality": "fixed",
"shirshodaya": true
},
"moon": {
"sign": "Scorpio",
"degree": 7.81,
"house": 1,
"quality": "fixed",
"lastContact": null,
"nextContact": {
"faster": "Moon",
"slower": "Mars",
"relation": "5-9",
"friendly": true,
"separation": 7.16,
"orb": 10,
"state": "ithasala",
"line": "Moon 7.81° Scorpio → Mars 14.97° Cancer: 5-9, ithaśāla (applying, within the 10° orb), 7.16° apart"
},
"voidOfCourse": false
},
"significators": {
"querent": "Mars",
"counterparty": "Venus",
"undertaking": "Sun",
"gain": "Mercury",
"matter": {
"house": 7,
"lord": "Venus",
"why": "the 7th is the other party and the contract between you"
}
},
"contacts": [
{
"faster": "Venus",
"slower": "Mars",
"relation": "4-10",
"friendly": false,
"separation": 3.04,
"orb": 7.5,
"state": "indeterminate",
"line": "Venus 11.93° Libra → Mars 14.97° Cancer: 4-10, Venus is retrograde, so the application is not asserted, 3.04° apart"
},
{
"faster": "Sun",
"slower": "Mars",
"relation": "3-11",
"friendly": true,
"separation": 11.67,
"orb": 11.5,
"state": "separated",
"line": "Sun 26.64° Virgo → Mars 14.97° Cancer: 3-11, separated, out of orb, 11.67° apart"
},
{
"faster": "Mercury",
"slower": "Mars",
"relation": "4-10",
"friendly": false,
"separation": 6.59,
"orb": 7.5,
"state": "isarapha",
"line": "Mercury 21.55° Libra → Mars 14.97° Cancer: 4-10, iśarāpha (separating, within the 7.5° orb), 6.59° apart"
},
"… 1 more"
],
"grounds": [
{
"id": "lords_1_7",
"rule": "Lagnesa in itthasala/muthasila with 7L — the parties come to an agreement; 3-11 and 5-9 smoothly, 1-7 and 4-10 after obstacles (Praśnatantra 2.87a, 2.92).",
"book": "Advanced Prashna (Sarajit Poddar), quoting Nīlakaṇṭha's Praśnatantra",
"holds": false,
"direction": "neutral",
"because": "You (Mars, lagna lord) and Northwind supply contract (Venus, 7th lord): Venus 11.93° Libra → Mars 14.97° Cancer: 4-10, Venus is retrograde, so the application is not asserted, 3.04° apart."
},
{
"id": "lords_1_10",
"rule": "\"Lagnesa in Muthasila with 10L promises success to the Prcchaka\" (Praśnatantra 2.91b).",
"book": "Advanced Prashna (Sarajit Poddar), quoting Nīlakaṇṭha's Praśnatantra",
"holds": false,
"direction": "neutral",
"because": "Lagna lord Mars with 10th lord Sun: Sun 26.64° Virgo → Mars 14.97° Cancer: 3-11, separated, out of orb, 11.67° apart."
},
{
"id": "benefic_10th",
"rule": "\"Saumyas in 10H … promises success to the subject\" (Praśnatantra 3.45).",
"book": "Advanced Prashna (Sarajit Poddar), quoting Nīlakaṇṭha's Praśnatantra",
"holds": false,
"direction": "neutral",
"because": "No natural benefic in the 10th."
},
"… 10 more"
],
"verdict": {
"label": "perfects_after_obstacles",
"meaning": "the connection forms, but against stated obstacles",
"line": "Perfects through Moon→Mars (5-9, ithasala); obstacles: the lagna acts as fixed (Scorpio) — the status quo resists.",
"gain": "indicated",
"gainLine": "Gain is indicated from the 11th."
},
"natalCrossCheck": {
"onIso": "2026-11-02",
"window": {
"fromIso": "2026-10-31",
"toIso": "2027-01-25",
"mahadasha": "Sun",
"antardasha": "Mercury",
"label": "guarded",
"meaning": "low fixed cost only — no lease, no borrowing",
"peak": false,
"reasons": [
"antardaśā lord Mercury in Aries, the 8th (a dusthāna), yuvā avasthā (full delivery) — fitness 35",
"Mercury rules the 1st and 10th",
"within Sun's mahādaśā, and Sun is weak (Sun in Aries, the 8th (a dusthāna), mṛta avasthā (delivery muted))"
]
},
"transitsRead": true,
"agreement": "partial",
"statement": "PARTIAL: the praśna says the deal perfects; the birth chart's commitment calendar marks it GUARDED — low fixed cost only — no lease, no borrowing (2026-11-02, Sun/Mercury, 2026-10-31 → 2027-01-25). Not in conflict, and not the same answer."
},
"notEncoded": [
"Praśnatantra 3.46 (Moon in the lagna in itthasala with Mars → the querent \"captured or killed\"): a death reading, refused by the praśna layer's policy.",
"KP horary sub-lord rules (KP Horary Houses 8 and 3; Bosmia): the cuspal sub-lord here is whole-sign, not KP.",
"Tājika contacts across a sign boundary, and the special yogas (Nakta, Yamayā, Rudda, Kambūla proper): not computed, not asserted.",
"… 1 more"
],
"method": "DEAL PRAŚNA — cast for the moment and place the question about THIS deal was asked. Significators: lagna lord = you, 7th lord = the counterparty or contract, 10th lord = the undertaking, 11th lord = gain. A deal perfects when an applying Tā…"
},
"kpHorary": {
"computed": true,
"data": {
"frame": "kp_horary",
"horaryNumber": 108,
"ayanamsha": "krishnamurti",
"ayanamshaValue": 24.1344,
"houseSystem": "placidus",
"cuspMomentIso": "2026-10-13T23:08:04.835Z",
"judgmentMomentIso": "2026-10-14T05:00:00.000Z",
"latitudeValidated": true,
"cusps": [
{
"house": 1,
"sign": "Virgo",
"degreeInSign": 3.0003,
"longitude": 153.0003,
"signLord": "Mercury",
"starLord": "Sun",
"subLord": "Saturn",
"subSubLord": "Saturn"
},
{
"house": 2,
"sign": "Libra",
"degreeInSign": 0.8914,
"longitude": 180.8914,
"signLord": "Venus",
"starLord": "Mars",
"subLord": "Mercury",
"subSubLord": "Moon"
},
{
"house": 3,
"sign": "Scorpio",
"degreeInSign": 1.3179,
"longitude": 211.3179,
"signLord": "Mars",
"starLord": "Jupiter",
"subLord": "Mars",
"subSubLord": "Moon"
},
"… 9 more"
],
"planets": [
{
"planet": "Sun",
"retrograde": false,
"sign": "Virgo",
"degreeInSign": 26.7359,
"longitude": 176.7359,
"signLord": "Mercury",
"starLord": "Mars",
"subLord": "Jupiter",
"subSubLord": "Mercury"
},
{
"planet": "Moon",
"retrograde": false,
"sign": "Scorpio",
"degreeInSign": 7.902,
"longitude": 217.902,
"signLord": "Mars",
"starLord": "Saturn",
"subLord": "Ketu",
"subSubLord": "Saturn"
},
{
"planet": "Mars",
"retrograde": false,
"sign": "Cancer",
"degreeInSign": 15.0631,
"longitude": 105.0631,
"signLord": "Moon",
"starLord": "Saturn",
"subLord": "Jupiter",
"subSubLord": "Jupiter"
},
"… 9 more"
],
"rulingPlanets": {
"dayLord": "Mercury",
"moonSignLord": "Mars",
"moonStarLord": "Saturn",
"ascendantSignLord": "Mars",
"ascendantStarLord": "Mercury",
"inOrder": [
"Mercury",
"Mars",
"Saturn"
]
},
"notComputed": [
"the judgment: which cusp sub-lord answers the question, and whether it signifies the houses that fulfil it",
"the significator ladder (planets in the star of occupants and owners) and the strongest-significator choice",
"ruling-planet refinements: Rāhu/Ketu as agents of their sign and star lord, dropping a retrograde planet"
]
}
},
"method": "Praśna (horary) is cast for the moment and place the question is asked, not for a birth: an independent classical method. Whole-sign houses in the Lahiri ayanāṁśa. `findings` are chart facts and hand-encoded classical dicta, each with wheth…"
}Every field: /v1/prashna in the reference.
Why AstroNest
Deterministic interpretation
Interpret, guidance, compatibility and guna milan call no language model: the same chart always gets the same reading. Only forecast and timing are voiced by a model, and they are marked as such.
Nothing silently missing
Every reading declares each of its layers as present, computed_empty, not_covered or failed, so an absent field is never left to guesswork.
Pricing
Sandbox keys are free, with no time limit, and return the samples above. A live key starts with 100 free credits; after that you buy credit packs. Each endpoint's cost in credits is shown above. Pricing
Questions
- Does it support horary numbers?
- Yes, 1 to 249.
- Is birth data required?
- No. Praśna works from the moment of the question; birth data is optional.
Readings are symbolic interpretation, not medical, legal, financial or psychological advice.
More from the API