Connect RoxyAPI to Your AI Agent

Explore a personal question through chart details or tarot symbolism.

33 tools API key

Try a RoxyAPI Task

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

oo Skill RoxyAPI

Read a Natal Chart

Resolve birth location before calculating a chart with historical time zone.

/oo RoxyAPI: Find my birth city [city, region, country] and confirm the location. Prepare a natal chart for [birth date and time] using the correct local time zone.

Explore a Tarot Spread

Request a three-card spread and explain the returned symbolism.

/oo RoxyAPI: Draw a three-card tarot spread for [question]. Explain the symbolism as reflection, without treating it as a certain prediction.

Start Working with RoxyAPI

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect RoxyAPI

    Connect with a RoxyAPI server-side sk_ secret key.

    Connect RoxyAPI →
  3. 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

  • An active RoxyAPI plan and server-side sk_ secret key.
  • Confirm country and province for ambiguous cities and use IANA timezone for historical daylight saving. Interpretations are not factual predictions.

RoxyAPI Tools

Resolve a birth location before requesting natal or BaZi chart data, or draw a tarot spread around a question. Confirmed birth details support chart preparation, while symbolic readings offer material for reflection rather than certain predictions.

Birth-Based Charts

Resolve cities and request natal, BaZi, or Human Design chart data.

Tarot and Calendar

Read tarot cards or spreads and convert lunar dates or inspect almanac days.

33 tools

Get Usage

Get API usage statistics.

roxyapi.get_usage

Search Cities

Search cities worldwide. Confirm province and country when multiple cities match; use timezone rather than today's utcOffset for birth charts.

roxyapi.search_cities

Get Natal Chart

Generate natal chart. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_natal_chart

Get Synastry

Calculate synastry. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_synastry

Get Daily Horoscope

Daily horoscope by zodiac sign.

roxyapi.get_daily_horoscope

Get Weekly Horoscope

Weekly horoscope by zodiac sign.

roxyapi.get_weekly_horoscope

Get Monthly Horoscope

Monthly horoscope by zodiac sign.

roxyapi.get_monthly_horoscope

Get Yearly Horoscope

Yearly horoscope by zodiac sign.

roxyapi.get_yearly_horoscope

Get Bazi Chart

Generate BaZi chart. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_bazi_chart

Get Bazi Compatibility

Calculate BaZi compatibility. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_bazi_compatibility

Get Bodygraph

Generate full Human Design bodygraph. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_bodygraph

Get Human Design Connection

Calculate Human Design connection chart. Resolve ambiguous places with search_cities first; prefer an IANA timezone for historical daylight saving.

roxyapi.get_human_design_connection

Get Numerology Chart

Generate numerology chart.

roxyapi.get_numerology_chart

Get Numerology Compatibility

Calculate numerology compatibility.

roxyapi.get_numerology_compatibility

List Tarot Cards

List all 78 tarot cards.

roxyapi.list_tarot_cards

Get Tarot Card

Get tarot card by id.

roxyapi.get_tarot_card

Draw Tarot Cards

Draw tarot cards.

roxyapi.draw_tarot_cards

Get Daily Tarot

Daily tarot card.

roxyapi.get_daily_tarot

Cast Yes No Tarot

Yes or no answer.

roxyapi.cast_yes_no_tarot

Cast Three Card Tarot

Three card spread, past present future.

roxyapi.cast_three_card_tarot

Cast Celtic Cross Tarot

Celtic Cross spread, 10 cards.

roxyapi.cast_celtic_cross_tarot

Cast Love Tarot

Love spread, 5 cards.

roxyapi.cast_love_tarot

Cast Career Tarot

Career spread, 7 cards.

roxyapi.cast_career_tarot

Cast Custom Tarot

Custom spread builder.

roxyapi.cast_custom_tarot

Cast Iching

Cast an I-Ching reading.

roxyapi.cast_iching

Get Forecast Timeline

Build a personal, cross-domain forecast timeline. The provider clamps the window to at most 90 days and caps events at 200; use returned startDate and endDate as the resolved window.

roxyapi.get_forecast_timeline

Get Forecast Digest

Summarize personal forecast events into the next 24 hours, 7 days, 30 days, and 90 days. Preserve explicit domains, weights, and per-window top-event count.

roxyapi.get_forecast_digest

Get Bazi Luck Pillars

Calculate BaZi ten-year luck pillars and the start age, with optional annual overlays.

roxyapi.get_bazi_luck_pillars

Get Bazi Day Master Strength

Assess BaZi Day Master strength with factor scores and favorable and unfavorable elements.

roxyapi.get_bazi_day_master_strength

Get Bazi Annual Forecast

Read a Gregorian year against a natal BaZi chart, including Ten Gods and pillar interactions.

roxyapi.get_bazi_annual_forecast

Convert Lunar Date

Convert a Gregorian date OR a complete lunar date. Omit both for today in UTC. The calendar uses the UTC+8 reference meridian; isLeapMonth selects the repeated lunar month.

roxyapi.convert_lunar_date

Get Almanac Day

Get the Chinese almanac for a date in years 1900 through 2100, with lunar date, pillars, day officer, mansion, favored and avoided activities.

roxyapi.get_almanac_day

Find Auspicious Days

Find days favored for an activity within a date range of at most 93 days, optionally excluding dates clashing with a zodiac animal.

roxyapi.find_auspicious_days

Frequently Asked Questions

What birth details are needed?

Provide the date, local time, and confirmed city. The correct time zone matters for historical daylight-saving changes.

Are tarot readings certain predictions?

No. Use the symbolism for reflection and discussion.

Connect RoxyAPI

About RoxyAPI ↗