astro-agent-dev Free API

openapi: 3.2.0
info:
  title: Astro Agents Free API
  version: 1.8.0
  summary: Verifiable planetary timing data for market analysis & backtesting — the real NASA/JPL DE440, reproducible and SHA-256 proven. For traders, quants and agents.
  description: 'Astro Agents — verifiable celestial & market-timing data for traders, quants and AI agents. Exact planetary positions (geocentric & heliocentric), declination, Gann planetary lines, planetary cycles and a to-the-minute celestial event calendar (ingresses, stations, eclipses) from the real NASA/JPL DE440 ephemeris — no LLM, every result reproducible and SHA-256 verifiable, so you can backtest and cite with no second-guessing. Pay per call natively in MCP with x402 (USDC on Base or Solana): zero setup, no account; or over REST (x402/MPP) or with prepaid credit packs. Full Western & Vedic astrology too (natal, kundli, dashas, KP, yogas). Data for your own analysis — never a trading signal or forecast.


    Pay per call with **x402** (USDC on Base or Solana) or **MPP** (Tempo: OUSD or USDC.e). No account, no API key. 1 free call per client on the $0.01-0.02 routes, over REST, MCP or A2A; every other route, finance included, is always paid.


    Official Python client: `pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python"` (https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python#readme).


    - Positions from NASA/JPL DE440 (NASA/JPL), 1800-01-01..2200-01-01, via Skyfield: geocentric apparent, true equinox of date, IAU 2006/2000A.

    - Historical time zones resolved for you (IANA tz database, DST of the era, Local Mean Time); ambiguous or non-existent local times are flagged, never guessed.

    - Deterministic, no LLM: same input -> same bytes. Every response carries meta.input_sha256 and meta.result_sha256 (also as X-Input-SHA256 / X-Result-SHA256 headers); POST /v1/verify recomputes one.

    - Every convention is in the response: ayanamsa (name, true and mean value), house system, orbs, node type, dasha year length, dosha and koota rule sets.

    - Cross-validated against an independent engine (XALEN, Apache-2.0): ayanamsas agree to < 0.1", 15/16 divisional charts identically, all 11 house systems in structure.

    - Accuracy vs NASA/JPL Horizons (12,400 comparisons, 1800-2199): positions within 0.024" (ICRF); ecliptic longitudes as served within 0.062" over 1962-2026. Method and every number: https://astro-agent.dev/benchmark.md'
  x-sdks:
  - language: python
    package: astro-agents
    install: pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python"
    url: https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python#readme
  x-guidance: 'Verifiable market-timing data for trading bots, quants and backtests (NASA/JPL DE440, no LLM, SHA-256 per result): POST /v1/finance/planetary-lines (Gann lines, geo + helio, series), /v1/finance/events (eclipses, Mercury retrograde and other stations, ingresses, aspects, 1800-2200, to the minute), /v1/finance/analogues (dates whose sky best matches a reference, by a stated angular distance) and /v1/western/positions ($0.01). Pay per call with x402 (USDC on Base or Solana) or MPP, or inside MCP at /mcp. Data for your own analysis, never a signal or forecast. Astrology charts too: every chart endpoint takes a JSON body with a local ''datetime'' (e.g. ''1990-05-15T14:30''), ''latitude'' and ''longitude''; the historical time zone is resolved for you. Cheapest calls: POST /v1/western/positions ($0.01) and /v1/vedic/nakshatra ($0.02). Western natal chart: POST /v1/western/natal. Vedic birth chart: POST /v1/vedic/kundli. Marriage compatibility: POST /v1/vedic/gun-milan with person_a and person_b. Each response carries meta.result_sha256; POST /v1/verify recomputes it. 1 free call per client on the $0.01-0.02 routes. Free catalog: GET /v1/catalog. /v1/finance/analogues also takes reference {birth: {datetime, latitude, longitude}} to compare a birth sky to past/future dates, data only. Crypto tokens: /v1/finance/token-chart (a token''s launch sky and the key astronomical dates ahead, with an SVG card) and /v1/finance/token-synastry (two launch skies compared by geometry, with an SVG card).'
  contact:
    name: Astro Agents support
    email: aidatatools@proton.me
    url: https://astro-agent.dev/support
  termsOfService: https://astro-agent.dev/terms
servers:
- url: https://astro-agent.dev
tags:
- name: free
paths:
  /v1/catalog:
    get:
      operationId: getCatalog
      summary: 'Catalog: every endpoint, price, schema, example (free)'
      tags:
      - free
      security: []
      responses:
        '200':
          description: Catalog
          content:
            application/json:
              schema:
                type: object
  /v1/health:
    get:
      operationId: getHealth
      summary: Liveness, versions, live payment status (free)
      tags:
      - free
      security: []
      responses:
        '200':
          description: OK
  /v1/verify:
    post:
      operationId: verifyResultHash
      tags:
      - free
      security: []
      summary: Recompute the SHA-256 of a result (free)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - result
              properties:
                result:
                  type: object
                result_sha256:
                  type: string
      responses:
        '200':
          description: Hash and match flag
externalDocs:
  description: Official Python client (pandas DataFrames)
  url: https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python#readme
x-service-info:
  categories:
  - finance
  - data
  - trading
  primaryCategory: Data / Finance / Trading
  tags:
  - finance
  - trading
  - backtesting
  - quant
  - crypto
  - market-timing
  - financial-astrology
  - gann
  - ephemeris
  - planetary-data
  - astrology
  docs:
    homepage: https://astro-agent.dev
    apiReference: https://astro-agent.dev/openapi.json
    llms: https://astro-agent.dev/llms.txt
    privacy: https://astro-agent.dev/privacy
    terms: https://astro-agent.dev/terms
    support: https://astro-agent.dev/support
  mcp: https://astro-agent.dev/mcp
  a2a: https://astro-agent.dev/a2a
  catalog: https://astro-agent.dev/v1/catalog
x-discovery:
  ownershipProofs:
  - '0x6d5d44a7db34518bbf90738ec44e5b3d33224f6c36fc9f2171ca681dbd0ca35b36c22541db24e5b66532d3b12dc017b8a610480c75b41322a51fe3e55d0ff06c1b'