U.S.-based · Built for curiosity. Ready for integration.

Astrology, readings & Tarot.
APIs for your app.

Generate birth charts, synastry comparisons and transit charts for your app. Use Western and Vedic-oriented astrology APIs, then add birth-chart readings and Tarot. Integrate on your server with Node.js, TypeScript or Python.

Start free with no credit card. Use 500 standard requests each UTC month, then choose a plan when your application needs more.

Tropical natal chart wheel generated by Cosmic Ephemeris from neutral demonstration data
FormatSVG or PNG
ModelTropical · Equal houses
SourceStructured API response

A genuine output from the natal chart renderer using neutral demonstration data: January 1, 2000 at 12:00 UTC, 0° latitude and 0° longitude. Review the renderer contract.

One platform. Built for developers.

Your product. Our calculation APIs.

Cosmic Ephemeris is a U.S.-based astrology service in Georgia, United States. Integrate documented calculations, symbolic readings and Tarot into your own product.

A longer view of the sky

1000 BCE (BC) to 2500 CE (AD)

Explore historical date support

All 77 date-bearing operations accept explicit historical inputs. Choose your calendar and time convention; each tool keeps its documented search, geometry and output limits. Place search is date-independent.

78
Live calculation APIs
24
Supported divisional charts
3
Languages for readings APIs
78
Original Tarot cards

More ways to build

Build readings into your experience.

Add evidence-linked symbolic readings and Tarot to your application through server-side APIs. You own the user experience.

From placements to perspective
  1. 01 Send birth inputs
  2. 02 Receive symbolic themes
  3. 03 Render in your app

Readings

Meet the meaning.
Keep the evidence.

Explore Western and Vedic birth-chart readings, relationship compatibility, Pythagorean numerology, and sampled daily, weekly and annual themes.

  • English, Hindi and Spanish reading text
  • Planet-specific explanations with calculation references
  • Structured JSON with disclosures and content versions
  • Preset guided explanations grounded in returned evidence
Explore Readings

Server-side API key required. One standard credit per admitted attempt. No external AI provider is called.

The Star, The Sun and The Moon from the original Cosmic Symbols Tarot deck
Original Cosmic Symbols artwork · Sample cards, not a draw

Tarot · Server-side integration

Cards and meanings.
Your interface.

Build with 78 card identities, upright or reversed meanings, and general, relationship or career themes. The API returns structured JSON; your application supplies the artwork and interface.

  • Card of the day and single-card draws
  • Three-card spreads and the Celtic Cross
  • Card identities, meanings and versioned JSON
  • Scoped API keys and standard credit accounting
Explore Tarot

English, Spanish and Hindi. Stateless API draws use one standard credit per admitted attempt; your application owns storage and display.

Readings and Tarot meanings are AI-assisted symbolic reflections, not scientifically validated predictions. Translations are also AI-assisted. See what is included and how it works.

For developers and teams

From calculation to customer-ready output

Use one documented platform for the data, visuals, and server-side workflow behind your astrology application.

All 78 documented calculations are live. Start with the capabilities your product needs and follow each method to its inputs, limits, and examples.

Calculate

Western, sidereal, and Vedic-oriented data

Build with charts, houses, aspects, transits, synastry, timing methods, divisional charts, dasha periods, Panchang, and bounded event searches.

Browse calculation APIs

Present

Charts, maps, and reports your product can use

Return structured JSON, render original SVG or PNG charts, create bounded astrocartography maps, and generate downloadable report formats.

Explore maps and reports

Operate

Production controls for developers and teams

Use server-side SDKs, scoped keys, per-key budgets, saved inputs, queued batch work, signed webhooks, workspaces, and MCP integrations.

Explore the developer platform
JPL ephemeris dataPlanetary calculations use JPL DE440 and DE441 data, with documented methods and published accuracy comparisons.
Reproducible outputDeclared conventions, calculation fingerprints, and artifact hashes support verification.
Explicit time conventionsResolve standard civil time with IANA zones; choose a calendar and UT1 convention for historical inputs.

Straight answers

Good questions. Clear answers.

What is included, how to get started, and where the limits are. Open only the details you need.

Does Cosmic Ephemeris use Swiss Ephemeris or JPL?

Cosmic Ephemeris calculates planetary positions using JPL DE440 and DE441 data through Skyfield. Selected calculations are checked against recorded Swiss Ephemeris/Moshier reference results.

Where is Cosmic Ephemeris based?

Cosmic Ephemeris is based in the United States.

Can I use Tarot, readings and Vedic calendars through an API?

Yes. Three supplemental APIs provide Tarot draws, symbolic readings and Vedic systems, separate from the 78-calculation catalog. They are available over HTTPS and through the cosmicephemeris_symbolic MCP tool. Node/Python 0.5.0 includes the corresponding methods; packages are published on npm and PyPI. Your application controls presentation, storage and exports.

Can I get readings without building an app?

Readings are available through our server-side APIs for developers to integrate into their own applications. There is no on-site reading generator.

Is Tarot part of the calculation API?

Tarot is a separate supplemental API, outside the 78-tool calculation catalog. It offers 78 cards in English, Spanish and Hindi through a scoped server-side key, using one standard credit per admitted attempt. Your application renders and stores the result; there is no on-site card-drawing tool.

Can I start for free?

Free includes 500 standard API requests per UTC calendar month with no credit card required. Tropical and sidereal chart calculations are included.

What features are available?

Cosmic Ephemeris provides 78 live calculation endpoints. Coverage includes charts, houses, aspects, transits, synastry, SVG and PNG rendering, Western timing methods, twenty-four Vargas, Vimshottari through optional depth 4, Panchang, Ashtakoota, Ashtakavarga, Moon phases, planetary and house events, aspect windows, unified calendars, bounded eclipse and electional tools, relocation, astrocartography, reports, birth-time audits, six fixed stars, and symbolic numerology. Every plan includes 77 endpoints; Nakshatra Timeline requires Pro. Each method’s documented inputs, limits, and exclusions remain part of the contract.

What developer-platform features are included?

All plans can use server-side API keys, projects, development/staging/production controls, per-key budgets, saved chart inputs, team workspaces, signed job-completion webhooks, deterministic report downloads and MCP. MCP exposes the 78-operation catalog, but calls retain each route's plan entitlement; Nakshatra Timeline still requires Pro. A separate MCP tool provides Tarot draws, symbolic readings and supplemental Vedic systems. Durable jobs accept one to ten items from fourteen fixed operations through JSON or bounded NDJSON, with the same scopes, budgets, quotas and one-unit-per-item accounting as synchronous calls.

Does Cosmic Ephemeris support Western and Vedic astrology?

Cosmic Ephemeris supports tropical calculations for Western astrology and sidereal charts with Lahiri, Raman, Krishnamurti, Fagan–Bradley, Yukteshwar, Sassanian, True Chitra, True Revati, True Pushya, Galactic Center at 0 Sagittarius, or Galactic Alignment/Mardyks ayanamsa. Moon nakshatra/pada data and supported D1/D2/D3/D4/D5/D6/D7/D8/D9/D10/D11/D12/D16/D20/D24/D27/D30/D40/D45/D60/D81/D108/D144/D150, Vimshottari, Indian SVG and instant Panchang calculations support Vedic-oriented applications. Panchang uses an explicit USNO solar-event model and latitude limits. Supplemental Vedic systems add Yogini periods, regional calendar factors and North/South Hindu calendar presets with 18 named observances each. These are documented, bounded methods, not complete regional calendars or a complete Jyotish system.

Which house systems and dates are supported?

The Houses API offers 25 explicit choices: Equal, Whole Sign, 22 current opt-in twelve-house systems, and Houses-only Gauquelin sectors. Natal SVG supports the 24 twelve-house choices; Gauquelin is excluded there. Undefined geometry returns an error without fallback. Standard civil dates cover 1800–2200, with IANA timezones or UTC defaults. On all 77 date-bearing operations, explicit historical inputs cover 1000 BCE (BC)–2500 CE (AD), with an explicit proleptic calendar and, for timed calculations, UT1 or a fixed UT1 offset. Numerology requires an explicit year-digit convention; place search is date-independent. Historical mode has no year zero and does not infer ancient timezones; per-tool limits apply.

Does Cosmic Ephemeris calculate solar-arc directions?

Yes. The current solar-arc endpoint rotates natal planets and Ascendant/MC using either the default true tropical Sun arc or the explicit mean-Naibod longitude key, with tropical or sidereal output and synthetic Equal or Whole Sign houses. It does not calculate physical event charts, converse directions or predictions. Each admitted calculation uses one standard request.

Does Cosmic Ephemeris support Pratyantardasha?

Yes. The current Vimshottari endpoint returns major periods and Antardasha by default. Depth 3 adds 729 Pratyantardashas; depth 4 adds 6,561 bounded Sookshma periods. It uses a fixed 365.25-day year, supports Lahiri, Raman, Krishnamurti, Fagan–Bradley, Yukteshwar, Sassanian, True Chitra, True Revati, True Pushya, Galactic Center at 0 Sagittarius, and Galactic Alignment/Mardyks ayanamsas, and costs one standard request per admitted synchronous calculation. The separate supplemental Vedic API also supports Yogini periods. Other dasha systems and deeper Vimshottari levels are not supported.

Are more sidereal systems, Moon phases, asteroids and fixed stars included?

Cosmic Ephemeris currently supports Lahiri, Raman, Krishnamurti, Fagan–Bradley, Yukteshwar, Sassanian, True Chitra, True Revati, True Pushya, Galactic Center at 0 Sagittarius, and Galactic Alignment/Mardyks ayanamsas, not every sidereal system offered by other products. The bounded six-star CC0 catalog is available; asteroid and minor-body calculations are not offered. Separate current methods provide Moon-phase calendars, bounded global eclipse geometry and hourly electional filtering. They do not provide local eclipse visibility or paths, crescent visibility, continuous electional guarantees, rankings or advice. Solar/lunar returns find natal-longitude returns, not new or full moons.

How API key storage works

The dashboard shows the full plaintext of a newly created or rotated key once. The production database retains a one-way SHA-256 digest and an eight-character display prefix, not a recoverable full key. Keep the plaintext key in your server-side secret manager and rotate it after suspected exposure.

Start with a question. Build from there.

Explore first. Choose a plan when you need more.

500 standard API requests per UTC calendar month on Free. No credit card required. Tarot and symbolic readings use standard API credits.

Technology partner

Explore a related research workspace.

TimeMatrix keeps its own application, accounts, credentials, subscriptions, data, and policies.

Partnered with TimeMatrix

Explore price, time, and planetary cycles.

TimeMatrix brings advanced market charting, Gann tools, and financial-astrology research into one browser-based workspace.

Related products. Separate accounts, subscriptions, and policies.

Explore TimeMatrix