Connect FreeAstroAPI to Your AI Agent

Turn calculated pillars and calendar symbols into a readable cultural reference.

Try a FreeAstroAPI Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill FreeAstroAPI

Explain a BaZi calculation

Resolve a location and calculate pillars with the chosen time convention.

/oo FreeAstroAPI: Resolve birth location [city], then calculate FreeAstroAPI BaZi for [date and local time], sex [value], timezone [zone] and time standard [civil or solar convention]. Explain pillars and Ten Gods as traditional references, retaining location and time assumptions.

Start Working with FreeAstroAPI

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect FreeAstroAPI

Connect with a FreeAstroAPI key from your dashboard.
Connect FreeAstroAPI →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

For BaZi, provide the date, local birth time, city or coordinates, time zone and chosen clock or solar-time convention.
Some lunar and transit calculations require specified account plans. Traditional chart interpretations are cultural references rather than evidence of future outcomes.

FreeAstroAPI Tools

Calculate BaZi and Vedic charts, numerology profiles and celestial position or lunar calendar data. AI can explain chart symbols and input assumptions, and distinguish traditional interpretations from astronomical calculations.

Traditional chart calculations

Calculate charts, compatibility and symbol references under selected conventions.

Location, calendars and sky data

Resolve coordinates and time zones and read calendar, lunar and celestial calculations.

17 tools

Calculate Bazi

Calculate a complete BaZi chart with four pillars, Day Master, Ten Gods, luck cycles, and optional professional analysis.

freeastroapi.calculate_bazi

Calculate Bazi Synastry

Analyze compatibility between two BaZi charts with independent calendar and time settings.

freeastroapi.calculate_bazi_synastry

Correct Bazi Time

Convert local civil time to local mean and relative or absolute true solar time.

freeastroapi.correct_bazi_time

Calculate Bazi Flow

Calculate annual and monthly BaZi flow pillars, interactions, and stars for one prediction year, with optional timezone and solar-time settings.

freeastroapi.calculate_bazi_flow

Calculate Bazi Life Curve

Calculate traditional Neijing Jing, Qi, and Shen age trajectories with BaZi luck-cycle adjustments.

freeastroapi.calculate_bazi_life_curve

Analyze Bazi Constitution

Analyze traditional BaZi and TCM constitution tendencies and timing patterns; this is not medical advice, diagnosis, or treatment.

freeastroapi.analyze_bazi_constitution

Get Chinese Calendar

Convert a Gregorian date to the Chinese lunar calendar, zodiac, solar terms, and festivals.

freeastroapi.get_chinese_calendar

Get Current Pillars

Get the four pillars and element balance at the current UTC instant.

freeastroapi.get_current_pillars

Get Bazi Dictionary

Get the stable ID mappings for BaZi interactions and symbolic stars.

freeastroapi.get_bazi_dictionary

Search Cities

Search cities and localities, including province-qualified queries, and return coordinates and IANA timezones for subsequent chart calculations.

freeastroapi.search_cities

Get Moon Phase

Get moon phase, illumination, and optional zodiac, rise/set, eclipse, forecasts, interpretation, and SVG visuals for a date or the current instant.

freeastroapi.get_moon_phase

Get Moon Calendar

Get a complete monthly moon calendar with optional SVG visuals, eclipses, forecasts, sign intervals, and ingress events. Requires an Entry or High plan.

freeastroapi.get_moon_calendar

List Sky Events

Get planetary ingresses, exact aspects, stations, and lunations for a local calendar date. This returns event data for downstream notifications.

freeastroapi.list_sky_events

Calculate Ephemeris

Calculate celestial positions at an instant or over a date range, including optional aspects, houses, angles, fixed stars, Moon void-of-course data, and table outputs.

freeastroapi.calculate_ephemeris

Calculate Transit Timeline

Calculate transit-to-natal intervals for a calendar month or a long-cycle range up to 366 days, with configurable planets, points, aspects, and orbs. Requires a High plan.

freeastroapi.calculate_transit_timeline

Calculate Vedic Chart

Run the V2 integrated Vedic calculation with optional divisional charts, Dasha, Yogas, Panchang, Shadbala, Ashtakavarga, and Avastha.

freeastroapi.calculate_vedic_chart

Calculate Numerology Profile

Calculate a Pythagorean, Chaldean, Kabbalah/Gematria, or Ank Jyotish profile with method-specific name, date, transliteration, and optional interpretation settings.

freeastroapi.calculate_numerology_profile

Frequently Asked Questions

What if the birth time is unknown?

Say that it is unknown. BaZi defaults to noon when the hour is omitted, so any hour-based interpretation must retain that assumption.

Can I compare clock time with solar time?

Yes. Use the time correction operation with the date and location, then choose the desired time standard for the chart.

Can one BaZi flow query cover multiple years?

It calculates one target year with annual and monthly data. Request additional years separately.