# Astro Agents Vedic Nakshatra API

> Astro Agents Vedic Nakshatra API is a paid API for AI agents from astro-agent.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Calculates the Vedic nakshatra (lunar mansion) and its attributes for a given birth date, time, and geographic location using the NASA/JPL DE440 ephemeris.

## Facts

- Endpoint: POST https://astro-agent.dev/v1/vedic/nakshatra?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/astro-agents-vedic-nakshatra-api-bc4940cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PMUQSW-I0ZL47Ufj0fOHb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability astro-agents-vedic-nakshatra-api-bc4940cd -d '<json body>'
```

Example prompt: What is the janma nakshatra for someone born on March 15, 1990 at 10:30 AM in New Delhi, India (28.6139° N, 77.2090° E), using the Lahiri ayanamsa?

## When to prefer this

Choose this endpoint when you need a deterministic, reproducible Vedic nakshatra calculation grounded in the NASA/JPL DE440 ephemeris with no LLM involvement. It is ideal for astrology apps, natal chart pipelines, or audit-sensitive applications where result hashing and reproducibility are required. Prefer this over LLM-based astrology responses when accuracy, verifiability, and support for multiple ayanamsa systems (Lahiri, Krishnamurti, Raman, etc.) matter.

## Known failure modes

- Missing required date/time or coordinates returns a validation error
- Invalid latitude or longitude values (out of -90 to 90 / -180 to 180 range) return a 400 error
- Ambiguous local time near DST transitions may require the ambiguous_time parameter to be set
- Dates outside the ephemeris range (1800-01-01 to 2200-01-01) are not supported
- Unsupported ayanamsa or house system enum values return a validation error

## How this service works

Nakshatras: Sidereal nakshatra, pada and lord of every graha; janma nakshatra with gana, yoni, nadi, varna.

## Output

Returns the janma nakshatra name, pada (quarter), and nakshatra lord, along with extended attributes (gana, nadi, yoni), plus metadata including the ephemeris version, whether any LLM was used (always false), and a SHA-256 hash of the result for reproducibility verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {
      "date": {
       "type": "string"
      },
      "time": {
       "type": "string"
      },
      "options": {
       "type": "object",
       "properties": {
        "ayanamsa": {
         "enum": [
          "fagan_bradley",
          "krishnamurti",
          "lahiri",
          "raman",
          "true_chitrapaksha",
          "yukteshwar"
         ],
         "type": "string",
         "default": "lahiri"
        },
        "node_type": {
         "enum": [
          "mean",
          "true"
         ],
         "type": "string",
         "default": "mean"
        },
        "house_system": {
         "enum": [
          "whole_sign",
          "equal",
          "placidus",
          "porphyry",
          "koch"
         ],
         "type": "string",
         "default": "whole_sign"
        },
        "include_outer_planets": {
         "type": "boolean",
         "default": false
        }
       }
      },
      "datetime": {
       "type": "string"
      },
      "latitude": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "timezone": {
       "type": "string"
      },
      "longitude": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      },
      "time_basis": {
       "enum": [
        "civil",
        "utc",
        "lmt",
        "true_solar"
       ],
       "type": "string",
       "default": "civil"
      },
      "ambiguous_time": {
       "enum": [
        "earlier",
        "later"
       ],
       "type": "string",
       "default": "earlier"
      },
      "longitude_sidereal": {
       "type": "number"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "engine": "astro-agents/1.0.3",
   "llm_used": false,
   "ephemeris": "NASA/JPL DE440 (1800-01-01..2200-01-01)",
   "deterministic": true,
   "result_sha256": "b06f53384a24ffa061b80b7fce083ee7f8e1a1d07d22e7f6342ea60a06a48767"
  },
  "endpoint": "vedic/nakshatra",
  "result_excerpt": {
   "attributes": {
    "gana": "Manushya",
    "lord": "Sun",
    "nadi": "Antya",
    "yoni": "Mongoose"
   },
   "janma_nakshatra": {
    "pada": 2,
    "nakshatra": "Uttara Ashadha",
    "nakshatra_lord": "Sun"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/astro-agents-vedic-nakshatra-api-bc4940cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from astro-agent.dev](https://www.zero.xyz/host/astro-agent.dev/llms.txt)