vedicproof
vedic proof · computation

Shadbala API

What is a Shadbala API?

A Shadbala API scores the sixfold strength of each graha - positional, directional, temporal, motional, natural and aspectual - usually in units called virupas. Vedic Proof does not yet compute the six-part total. It returns the underlying placement, dignity and aspect data those strengths are derived from.

Request

Tools are called over MCP, so an assistant connected to https://vedicproof.com/mcp invokes get_databank itself. The arguments it sends are:

tool · get_databank
{
  "date_of_birth": "1994-01-19",
  "time_of_birth": "05:22",
  "city": "Kochi",
  "country": "India",
  "datasets": [
    "planets",
    "aspects",
    "houses"
  ]
}

Response

Every response carries a plain-language summary string plus structured data, and states the engine and ayanamsa it used. Abridged here for length.

result · json
{
  "data": {
    "planets": [ { "graha": "Saturn", "rasi": "Kumbha", "house": 3, "retrograde": false, "dignity": "own sign" } ],
    "aspects": [ { "from": "Saturn", "to": "Sun", "type": "special", "houses": 3 } ]
  }
}

Which six strengths make up Shadbala?

BalaDerived from
SthanaPositional dignity, exaltation, varga placement
DigDirectional strength by house
KaalaTime of birth: day, night, year, month, hora
CheshtaMotional state, including retrogression
NaisargikaFixed natural strength of each graha
Drig balaNet aspectual strength from other grahas

How is this calculated and verified?

These are the pinned parameters that affect this computation. The full disclosure, and the golden-chart corpus, live on /proof.

House systemWhole sign (rasi bhava)
The lagna rasi is the first bhava in full; every graha's house is its rasi counted from the lagna rasi. Placidus, Sripati and KP cusps are not offered.
Ephemeris source and versionBuilt-in analytic series - not Swiss Ephemeris
Sun from a truncated VSOP-style series, Moon from truncated ELP2000 terms, and Mercury through Saturn from JPL Keplerian elements. Accuracy is arc-minutes, not arc-seconds: a few arc-minutes for the Sun and Moon, up to roughly a tenth of a degree for the outer grahas. That is fine for rasi, nakshatra, pada, dasha and koota output and is not fine for arc-second work. Every API response carries the engine note stating this.
AyanamsaLahiri (Chitrapaksha), mean
Single supported system today, computed as a polynomial in Julian centuries from J2000 rather than read from a table. True-Chitra, KP-Newcomb and Raman are not offered; that is a limitation, not a default we are hiding.

Common questions

Does this API return a virupa total?
No, and it will not claim one until it computes one. The placement, dignity, retrogression and aspect data returned are the inputs; the six-part total is on the roadmap.
Why publish a page for something you do not compute?
Because a buyer comparing providers needs to know the answer before signing up. An honest gap is cheaper for both sides than a discovered one.
Which strength is most affected by ephemeris accuracy?
Cheshta bala, which depends on a graha's speed relative to its mean motion - arc-minute positional accuracy is the limiting factor there.

Connect this to Claude or ChatGPT with one URL: https://vedicproof.com/mcp. First 14 days unlimited and free, then $1.99/month.

claude setup →chatgpt setup →pricing →

Related computations

all computations in docs →