Overview

The Udhyath API gives you Swiss Ephemeris-grade Vedic astrology as simple JSON endpoints: rasi and all 16 divisional charts, KP sub lords, Ashtakavarga, bhava chalit, four dasha systems, panchanga and transits. All positions are sidereal (Lahiri ayanamsa by default; KP endpoints default to Krishnamurti).

Prefer clicking over reading? The interactive Swagger UI lets you call every endpoint from the browser with your token.

Quickstart

1. Create an account at the Udhyath app (top-right → Login / Sign up).
2. Top up your wallet — ＋ Add funds (UPI, cards, netbanking via Razorpay).
3. Generate a token — API & MCP page → Generate token. Copy the udh_… value; it is shown once.
4. Call the API:

curl -X POST $BASE/v1/birth-chart \
  -H "Authorization: Bearer udh_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 1947, "month": 8, "day": 15, "hour": 0, "minute": 0,
    "latitude": 28.6139, "longitude": 77.2090, "tz_name": "Asia/Kolkata"
  }'

Authentication

Every request carries your token in the Authorization header:

Authorization: Bearer udh_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Tokens are created and revoked on the API & MCP page. A revoked token stops working immediately. Only a SHA-256 hash is stored on our side — if you lose a token, revoke it and generate a new one. Keep tokens server-side; never embed them in client-side code.

Billing & pricing

• Every calculation call costs ₹0.10 (GET /v1/me is free).
• Charges draw from your prepaid wallet — the same wallet as the agent. No subscriptions, no minimums, no expiry.
• When the balance can't cover a call you get HTTP 402 and are not charged:

{
  "detail": {
    "error": "insufficient_balance",
    "message": "Top up your wallet at https://astrology.tejaswiservices.com ...",
    "call_fee": 0.1, "balance": 0.0, "currency": "INR"
  }
}

Track spend per token on the API & MCP page, or programmatically via GET /v1/me.

The birth object

All chart endpoints accept the same JSON body:

Endpoints

{
  "token_name": "my-app", "token_prefix": "udh_AbCdEfG",
  "balance": 99.0, "currency": "INR", "call_fee": 0.1, "calls_made": 42
}

{
  "meta": { "utc_time": "1947-08-14T18:30:00+00:00", "ayanamsa": "lahiri",
            "ayanamsa_value_deg": 23.077537, "julian_day": 2432412.270833 },
  "ascendant": { "sign": "Taurus", "dms": "07°43'56\"", "sign_lord": "Venus", ... },
  "planets": {
    "Sun":  { "sign": "Cancer", "dms": "27°59'13\"", "nakshatra":
              { "name": "Ashlesha", "pada": 4 }, "house_whole_sign": 3,
              "retrograde": false, ... },
    "Moon": { "sign": "Cancer", "nakshatra": { "name": "Pushya", "pada": 4 }, ... },
    ... 7 more grahas ...
  },
  "houses": [ { "house": 1, "sign": "Taurus", "sign_lord": "Venus",
                "planets": ["Rahu"] }, ... 11 more ... ],
  "panchanga": { "tithi": { "name": "Chaturdashi", "paksha": "Krishna" },
                 "vara": "Friday", "nakshatra": { "name": "Pushya", "pada": 4 },
                 "yoga": { "name": "..." }, "karana": { "name": "..." } }
}

{
  "varga": "D9",
  "signification": "Navamsa - spouse, marriage, dharma, inner strength",
  "ascendant_sign": "Pisces",
  "placements": {
    "Sun": { "sign": "Sagittarius", "house_from_varga_lagna": 10 },
    ... 8 more grahas ...
  }
}

{
  "charts": {
    "D1":  { "Lagna": "Taurus", "Sun": "Cancer", "Moon": "Cancer", ... },
    "D9":  { "Lagna": "Pisces", "Sun": "Sagittarius", ... },
    ... D2..D60 ...
  }
}

{
  "system": "KP (Krishnamurti Paddhati), Placidus cusps",
  "cusps": [
    { "cusp": 1, "sign": "Taurus", "sign_lord": "Venus", "star": "Krittika",
      "star_lord": "Sun", "sub_lord": "Venus", "sub_sub_lord": "Jupiter",
      "longitude": 37.83 },
    ... 11 more cusps ...
  ],
  "planets": {
    "Moon": { "sign": "Cancer", "star": "Pushya", "star_lord": "Saturn",
              "sub_lord": "Saturn", "sub_sub_lord": "Venus", ... },
    ... 8 more grahas ...
  }
}

{
  "bav": { "Sun": { "Aries": 4, "Taurus": 3, ... }, ... 6 more planets ... },
  "bav_totals": { "Sun": 48, "Moon": 49, "Mars": 39, "Mercury": 54,
                  "Jupiter": 56, "Venus": 52, "Saturn": 39 },
  "sav": { "Aries": 30, "Taurus": 28, ... },
  "sav_total": 337, "ascendant_sign": "Taurus"
}

{
  "system": "Sripati (Porphyry madhya)",
  "bhava_madhya": [37.73, 64.95, ...],
  "bhava_start": [24.12, 51.34, ...],
  "placements": { "Sun": 3, "Moon": 3, "Saturn": 3, "Rahu": 1, ... }
}

{
  "system": "Vimshottari", "birth_lord": "Saturn",
  "balance_years_at_birth": 18.07,
  "mahadashas": [
    { "lord": "Saturn", "start": "1946-09-10T...", "end": "1965-09-10T...",
      "years": 19,
      "antardashas": [
        { "lord": "Saturn", "start": "...", "end": "...",
          "sub_periods": [ { "lord": "Saturn", ... }, ... ] },
        ... 8 more ...
      ] },
    ... 8 more mahadashas ...
  ]
}

{
  "at": "2026-07-11T09:12:00+00:00",
  "mahadasha":       { "lord": "Mars",   "start": "...", "end": "..." },
  "antardasha":      { "lord": "Rahu",   "start": "...", "end": "..." },
  "pratyantardasha": { "lord": "Saturn", "start": "...", "end": "..." }
}

Errors

Rate limits

API Gateway throttles at 50 requests/second (burst 100) for the REST API and 20 rps for MCP. Need more? Reach out.

MCP server

The same 11 calculations are available as MCP tools for Claude Desktop, Claude Code, or any MCP client — authenticated with the same token, billed at the same ₹0.10/tool-call.

Hosted (Streamable HTTP):

{
  "mcpServers": {
    "udhyath": {
      "type": "http",
      "url": "https://mcp.astrology.tejaswiservices.com/mcp",
      "headers": { "Authorization": "Bearer udh_YOUR_TOKEN" }
    }
  }
}

Local (stdio) — run the server yourself; calls are billed through the hosted API:

{
  "mcpServers": {
    "udhyath": {
      "command": "python",
      "args": ["/path/to/mcp_server/server.py"],
      "env": {
        "UDHYATH_API_URL": "https://api.astrology.tejaswiservices.com",
        "UDHYATH_API_KEY": "udh_YOUR_TOKEN"
      }
    }
  }
}

Tools exposed: birth_chart, varga_chart, all_varga_charts, kp_chart, ashtakavarga, bhava_chalit_chart, dasha_periods, current_dasha, birth_panchanga, panchanga_today, transits.

🪔 Udhyath — Vedic astrology, computed precisely. Back to the app · Swagger · ReDoc