astro-agent-dev Finance API

openapi: 3.2.0
info:
  title: Astro Agents Finance 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:


# --- truncated at 32 KB (376 KB total) ---
# Full source: https://artifacts.apis.io/astro-agent-dev/openapi/astro-agent-dev-finance-api-openapi.yml