RoxyAPI

{
  "name": "RoxyAPI",
  "description": "AI-native data API for insight, prediction, and spiritual intelligence apps. 18 API domains with 258+ production endpoints covering astrology, vedic, forecast, human design, chinese astrology, feng shui, mesoamerican, vastu, numerology, kabbalah, tarot, biorhythm, ayurveda, i-ching, crystals, dreams, angel numbers, location. All endpoints return clean JSON with no wrapper objects. Remote MCP servers for zero-config AI agent integration.",
  "version": "2.0.0",
  "provider": {
    "organization": "RoxyAPI",
    "url": "https://roxyapi.com"
  },
  "documentationUrl": "https://roxyapi.com/llms.txt",
  "iconUrl": "https://roxyapi.com/logo.png",
  "supportedInterfaces": [
    {
      "url": "https://roxyapi.com/api/v2/astrology",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/vedic-astrology",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/forecast",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/human-design",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/chinese-astrology",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/feng-shui",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/mesoamerican-astrology",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/vastu",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/numerology",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/kabbalah",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/tarot",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/biorhythm",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/ayurveda",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/iching",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/crystals",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/dreams",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/angel-numbers",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://roxyapi.com/api/v2/location",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "apiKey": {
      "apiKeySecurityScheme": {
        "description": "API key from RoxyAPI subscription. Get a free test key at https://roxyapi.com/api-reference or subscribe at https://roxyapi.com/pricing",
        "location": "header",
        "name": "X-API-Key"
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {
        "apiKey": {
          "list": []
        }
      }
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "astrology-api",
      "name": "Astrology API",
      "description": "Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per sign and the dated sky events behind every reading, synastry compatibility scores, composite charts, solar and lunar returns, real-time transit aspects, and moon phases. 4 house systems (Placidus, Koch, Whole Sign, Equal) with accurate tropical ephemeris, aspect-pattern detection (Grand Trine, T-Square, Yod), astrocartography planetary lines, relocation charts, and local space maps for location based astrology, plus classical and professional points like fixed star conjunctions, Arabic lots, the asteroid goddesses (Ceres, Pallas, Juno, Vesta), mean and true Black Moon Lilith, and timing techniques like secondary progressions, solar arc directions, and annual profections. Built for horoscope platforms, astrology dating apps, AI chatbots, wellness products, and zodiac content engines. Schedule future horoscopes by date or by year for editorial workflows, no astronomy expertise needed. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/astrology. MCP: https://roxyapi.com/mcp/astrology. OpenAPI: https://roxyapi.com/api/v2/astrology/openapi.json",
      "tags": [
        "astrology",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/astrology/natal-chart"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic-astrology-api",
      "name": "Vedic Astrology API",
      "description": "Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan kundli matching, Vimshottari Dasha predictions, dosha detection with remedies, a 301-entry planetary yoga glossary with 48 of them chart-detected and evidenced, complete Panchang, and KP horary with 249-level sub-lord analysis. Calculations verified against NASA JPL Horizons at arc-second-level accuracy. Built for matrimonial apps, horoscope platforms, spiritual wellness services, and AI-powered astrology chatbots. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/vedic-astrology. MCP: https://roxyapi.com/mcp/vedic-astrology. OpenAPI: https://roxyapi.com/api/v2/vedic-astrology/openapi.json",
      "tags": [
        "vedic",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/vedic-astrology/birth-chart"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "forecast-api",
      "name": "Forecast API",
      "description": "Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm critical days, and Vimshottari dasha changes into one time-ordered forecast for a single subject. The only cross-domain forecast timeline behind one key, positions verified against NASA JPL Horizons, available over Remote MCP with typed SDKs. Horizon capped at 90 days. REST: https://roxyapi.com/api/v2/forecast. MCP: https://roxyapi.com/mcp/forecast. OpenAPI: https://roxyapi.com/api/v2/forecast/openapi.json",
      "tags": [
        "forecast",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/forecast/timeline"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "human-design-api",
      "name": "Human Design API",
      "description": "Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, defined channels, and all 26 gate activations, plus two-person connection charts and small-group Penta analysis. Planetary positions verified against NASA JPL Horizons, the Design side solved on the exact 88 degree solar arc. One key, Remote MCP, typed SDKs. REST: https://roxyapi.com/api/v2/human-design. MCP: https://roxyapi.com/mcp/human-design. OpenAPI: https://roxyapi.com/api/v2/human-design/openapi.json",
      "tags": [
        "human design",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/human-design/bodygraph"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "chinese-astrology-api",
      "name": "Chinese Astrology API",
      "description": "Calculate BaZi Four Pillars charts, Chinese zodiac signs, and the Chinese lunisolar calendar from any birth moment: year, month, day and hour pillars with hidden stems, Na Yin and Ten God relations, luck pillars, day master strength, and animal compatibility. The school splits that make two calculators disagree are typed parameters rather than hidden defaults, and every chart echoes the conventions it was computed under. Solar terms come back as astronomical instants, lunar dates convert in both directions with leap months placed correctly, and the Tong Shu almanac covers day officers, lunar mansions and date selection. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/chinese-astrology. MCP: https://roxyapi.com/mcp/chinese-astrology. OpenAPI: https://roxyapi.com/api/v2/chinese-astrology/openapi.json",
      "tags": [
        "chinese astrology",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/chinese-astrology/bazi/chart"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "feng-shui-api",
      "name": "Feng Shui API",
      "description": "Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mountains, Kua numbers and the full Eight Mansions map of favourable and unfavourable directions, annual and monthly star plates, the four annual afflictions with exact degree spans, the compass Bagua map and the 1864 to 2043 period table. Chinese years resolve at Li Chun, computed astronomically, so the boundary is right rather than assumed. One key, Remote MCP, typed SDKs. REST: https://roxyapi.com/api/v2/feng-shui. MCP: https://roxyapi.com/mcp/feng-shui. OpenAPI: https://roxyapi.com/api/v2/feng-shui/openapi.json",
      "tags": [
        "feng shui",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/feng-shui/flying-stars/natal"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "mesoamerican-astrology-api",
      "name": "Mesoamerican Astrology API",
      "description": "Calculate Mayan astrology day signs, the Tzolkin sacred round, the Haab year, the full Long Count and the Aztec tonalpohualli from any date: day sign and coefficient, trecena, Calendar Round, Lord of the Night, Year Bearer and the five point Cruz Maya, each with a composed reading. The correlation constant that makes two Mayan calculators disagree is a typed parameter with a named default rather than a hidden pick, and every response echoes the conventions it was computed under, so a saved chart stays reproducible. Both naming traditions ship on every sign, the Yucatec spelling and the K\u02bciche\u02bc name daykeepers actually use, and readings come back in every language the API ships. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/mesoamerican-astrology. MCP: https://roxyapi.com/mcp/mesoamerican-astrology. OpenAPI: https://roxyapi.com/api/v2/mesoamerican-astrology/openapi.json",
      "tags": [
        "mesoamerican",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/mesoamerican-astrology/mayan/chart"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vastu-api",
      "name": "Vastu Shastra API",
      "description": "Vastu Shastra API for directional home and plot analysis: entrance padas with the classical effect of each of the 32 perimeter positions, the Vastu Purusha Mandala projected over a real plot on the 81 pada or the 64 pada grid, room placement checks over a closed room enum, Ayadi shadvarga across three text families, plot shape and ground level under two schools that genuinely disagree, and griha pravesh dates composed over a verified panchang. Every verdict carries the chapter and verse it rests on as a typed field, or says plainly that it is convention. Directional design from Indian architecture, sitting beside our feng shui endpoints on one key, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/vastu. MCP: https://roxyapi.com/mcp/vastu. OpenAPI: https://roxyapi.com/api/v2/vastu/openapi.json",
      "tags": [
        "vastu",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/vastu/entrance"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "numerology-api",
      "name": "Numerology API",
      "description": "Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Challenge life-phase timing, Hidden Passion, Subconscious Self, and Cornerstone and Capstone name analysis. Birth day 1-31 profiles, lucky associations (colors, gemstones, planets), personal year and month forecasts, relationship compatibility, and karmic debt and lessons. Unicode-aware multilingual name handling transliterates Spanish, French, German, Russian, Hindi, Bengali, Tamil, Japanese, Chinese, Korean, Arabic, Greek, and Hebrew names to correct Pythagorean numbers so non-Latin scripts no longer drop letters. Both Pythagorean and Chaldean systems in one call, Cheiro compound numbers (10 to 52) with planetary rulers, and business and brand name analysis. Built for numerology apps, editorial platforms, AI chatbots, and wellness services. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/numerology. MCP: https://roxyapi.com/mcp/numerology. OpenAPI: https://roxyapi.com/api/v2/numerology/openapi.json",
      "tags": [
        "numerology",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/numerology/chart"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "kabbalah-api",
      "name": "Kabbalah API",
      "description": "Kabbalah API for gematria, the 72 names, the Tree of Life and the Hebrew birthday, from one key. Score a Hebrew word or a Latin name across ten rabbinic ciphers with the per letter breakdown, every candidate Hebrew spelling shown and the rule that chose one, plus a cited equal value lexicon. The 72 names are derived from the verses rather than copied from a table, the birth name is dated by the exact position of the Sun or by the civil wheel as you choose, and the sephirot, the 22 paths and the 22 letters come back under typed school variants cross linked to the tarot deck. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/kabbalah. MCP: https://roxyapi.com/mcp/kabbalah. OpenAPI: https://roxyapi.com/api/v2/kabbalah/openapi.json",
      "tags": [
        "kabbalah",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/kabbalah/gematria"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "tarot-api",
      "name": "Tarot Reading API",
      "description": "Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and spiritual growth. Celtic Cross, three-card, love, career, yes/no oracle, daily card, and custom spreads, each with upright and reversed interpretations. Seeded reproducibility for personalized daily readings, and card images included. Built for tarot apps, AI tarot chatbots, fortune-telling platforms, and spiritual wellness products. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/tarot. MCP: https://roxyapi.com/mcp/tarot. OpenAPI: https://roxyapi.com/api/v2/tarot/openapi.json",
      "tags": [
        "tarot",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/tarot/spreads/celtic-cross"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "biorhythm-api",
      "name": "Biorhythm API",
      "description": "The most complete biorhythm API: 10 cycle types across 3 primary (physical, emotional, intellectual), 4 secondary (intuitive, aesthetic, awareness, spiritual), and 3 composite (passion, mastery, wisdom). Critical-day detection with severity classification, 90-day forecasts with best and worst days, two-person compatibility scoring, phase tracking for dashboards, and seeded daily readings for push notifications. Localized into every language this API ships, deterministic results, and editorial-grade interpretations. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. Ship a biorhythm feature in hours, not weeks. REST: https://roxyapi.com/api/v2/biorhythm. MCP: https://roxyapi.com/mcp/biorhythm. OpenAPI: https://roxyapi.com/api/v2/biorhythm/openapi.json",
      "tags": [
        "biorhythm",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/biorhythm/reading"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ayurveda-api",
      "name": "Ayurveda API",
      "description": "Ayurveda API for dosha profiles, the dinacharya daily routine and the ritucharya seasonal regimen, with a verse cited on every value. Read the vata, pitta and kapha constitution from a verified sidereal birth chart, compute brahma muhurta and the six dosha periods from the real sunrise at any location, resolve the Ayurvedic season from actual solar ingress instants under two published conventions, and serve the catalogue of three doshas, fifteen sub-doshas, six tastes and twenty qualities straight from the primary texts. Deterministic, cacheable and localized. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/ayurveda. MCP: https://roxyapi.com/mcp/ayurveda. OpenAPI: https://roxyapi.com/api/v2/ayurveda/openapi.json",
      "tags": [
        "ayurveda",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "POST /api/v2/ayurveda/constitution"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "iching-api",
      "name": "I-Ching Oracle API",
      "description": "I-Ching oracle API with all 64 hexagrams, 384 changing lines, 8 trigrams, and modern interpretations for love, career, and decision-making. Cast readings with the authentic three-coin method, get a daily hexagram, and explore the Book of Changes programmatically. Built for divination apps, AI oracle chatbots, fortune-telling platforms, daily wisdom features, and spiritual guidance products. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/iching. MCP: https://roxyapi.com/mcp/iching. OpenAPI: https://roxyapi.com/api/v2/iching/openapi.json",
      "tags": [
        "i-ching",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "GET /api/v2/iching/cast?seed=user123-question1"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "crystals-api",
      "name": "Crystals and Healing Stones API",
      "description": "Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and Rose Quartz to Moldavite and Selenite, each with its spiritual, emotional, and physical properties. Filter by chakra (Root through Crown), zodiac sign, or element, search by keyword, browse birthstones by month, discover crystal pairings, and get random or daily crystal picks. Includes Mohs hardness, numerological vibration, and planetary associations per stone. Built for wellness apps, crystal shops, chakra-balancing tools, astrology integrations, and AI spiritual advisors. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/crystals. MCP: https://roxyapi.com/mcp/crystals. OpenAPI: https://roxyapi.com/api/v2/crystals/openapi.json",
      "tags": [
        "crystals",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "GET /api/v2/crystals/amethyst"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "dreams-api",
      "name": "Dream Interpretation API",
      "description": "Dream interpretation API with a 2,000+ symbol dream dictionary and psychological meanings covering animals, objects, emotions, people, scenarios, and abstract concepts. Decode dreams about falling, flying, teeth falling out, being chased, water, snakes, and more. Search, browse A-Z, or discover random symbols. Build dream journal apps, AI dream analysis chatbots, sleep-tracking features, and wellness platforms. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/dreams. MCP: https://roxyapi.com/mcp/dreams. OpenAPI: https://roxyapi.com/api/v2/dreams/openapi.json",
      "tags": [
        "dreams",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "GET /api/v2/dreams/symbols/snake"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "angel-numbers-api",
      "name": "Angel Numbers API",
      "description": "Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering every common family. Each reading breaks down into spiritual, love, career, money, and twin flame guidance, plus a biblical perspective and an honest shadow reading. Smart lookup analyzes any number sequence with pattern detection, digit-root calculation, classification, and an optional sighting-context note. Daily angel number endpoint, and filter by type (repeating, sequential, mirror, master, compound). Built for synchronicity apps, spiritual journals, daily guidance features, AI chatbots, and wellness platforms. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/angel-numbers. MCP: https://roxyapi.com/mcp/angel-numbers. OpenAPI: https://roxyapi.com/api/v2/angel-numbers/openapi.json",
      "tags": [
        "angel numbers",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "GET /api/v2/angel-numbers/numbers/444"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "location-api",
      "name": "Location and Timezone API",
      "description": "Location and timezone API with city search and geocoding across 235,000+ cities in 240+ countries, returning latitude, longitude, IANA timezone, and DST-aware UTC offset. Coverage goes down to towns of a few hundred people and every administrative seat, so a rural birthplace resolves as reliably as a capital. The location layer for birth chart forms, horoscope apps, event planners, and any feature that needs place-to-coordinates resolution. Fully offline dataset with no third party geocoding call, and fields that map directly to the astrology endpoints. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs. REST: https://roxyapi.com/api/v2/location. MCP: https://roxyapi.com/mcp/location. OpenAPI: https://roxyapi.com/api/v2/location/openapi.json",
      "tags": [
        "location",
        "api",
        "data",
        "mcp",
        "json"
      ],
      "examples": [
        "GET /api/v2/location/search?q=New York&limit=1"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}