RoxyAPI

RoxyAPI Western Astrology API

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.

GitHub OpenAPI

Operations 39

GET /astrology/signs Get all zodiac signs - Complete zodiac signs list with dates and elements #
GET /astrology/signs/{id} Get zodiac sign details - Complete astrology sign profile with personality… #
GET /astrology/planet-meanings Get all planet meanings - Complete astrology planet interpretations list #
GET /astrology/planet-meanings/{id} Get planet meaning details - Complete astrology planet interpretation #
POST /astrology/natal-chart Generate natal chart - Birth chart calculator API with houses and aspects #
POST /astrology/planets Get planetary positions - Ephemeris calculator for all planets #
POST /astrology/planets/monthly Monthly Ephemeris - Daily tropical planetary positions for a month #
GET /astrology/moon-phase/current Get current moon phase - Lunar phase calculator with zodiac sign #
GET /astrology/moon-phase/upcoming Get upcoming moon phases - Next new moon, full moon, quarters #
GET /astrology/moon-phase/calendar/{year}/{month} Get lunar calendar - Moon phases for entire month #
POST /astrology/synastry Calculate synastry - Relationship compatibility analysis API #
POST /astrology/houses Calculate house cusps - House system calculator with comparison #
POST /astrology/aspects Calculate planetary aspects - Aspect finder for any date and time #
POST /astrology/aspects/monthly Monthly Aspects - Tropical aspect calendar for an entire month #
POST /astrology/aspect-patterns Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic… #
POST /astrology/transits Calculate planetary transits - Current transits with natal chart comparison #
POST /astrology/transits/monthly Monthly Transits - Tropical sign ingresses for an entire month #
POST /astrology/transit-aspects Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations #
POST /astrology/parallels/monthly Monthly Parallels - Declination contacts for an entire month #
POST /astrology/ecliptic-crossings Ecliptic Crossings - Node passages for a whole year #
POST /astrology/solar-return Solar Return Chart - Annual birthday forecast with relocated chart #
POST /astrology/lunar-return Lunar Return Chart - Monthly emotional forecast with Moon cycle chart #
POST /astrology/composite-chart Composite Chart - Midpoint relationship chart with interpretations #
POST /astrology/compatibility-score Compatibility score - Relationship compatibility API #
GET /astrology/horoscope/{sign}/daily Daily horoscope by zodiac sign - Transit-based editorial columns #
GET /astrology/horoscope/{sign}/weekly Weekly horoscope by zodiac sign - Seven-day editorial column #
GET /astrology/horoscope/{sign}/monthly Monthly horoscope by zodiac sign - Editorial column with key dates #
GET /astrology/horoscope/{sign}/yearly Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods… #
POST /astrology/planetary-returns Planetary Return Chart - Saturn return, Jupiter return, and inner planet cycles #
POST /astrology/astrocartography Astrocartography map - planetary lines and relocation calculator #
POST /astrology/relocation-chart Generate relocation chart - Relocated birth chart calculator with shifted… #
POST /astrology/local-space Local space astrology map - Directional planetary compass lines #
POST /astrology/fixed-stars Fixed stars and star conjunctions calculator - Regulus, Spica, Algol natal… #
POST /astrology/arabic-lots Arabic lots calculator - seven Hermetic parts including Part of Fortune and… #
POST /astrology/asteroids Asteroid goddesses calculator - Ceres, Pallas, Juno, and Vesta natal positions #
POST /astrology/lilith Black Moon Lilith calculator - mean and true lunar apogee in the natal chart #
POST /astrology/progressions Secondary progressions calculator - progressed chart, progressed Sun and Moon #
POST /astrology/solar-arc Solar arc directions calculator - directed chart at one degree per year #
POST /astrology/profections Annual profections calculator - lord of the year and yearly time lord by age #

Documentation

📖
Documentation
https://roxyapi.com/docs/introduction
📖
Documentation
https://roxyapi.com/mcp/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/roxyapi/refs/heads/main/openapi/roxyapi-western-astrology-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://www.postman.com/roxylabs-7113570/roxyapi
🔗
LLMsTxt
https://roxyapi.com/llms.txt
🔗
AgentSkills
https://roxyapi.com/AGENTS.md
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/roxyapi/refs/heads/main/mcp/roxyapi-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/roxyapi:roxyapi-western-astrology-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

roxyapi-western-astrology-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Roxy Western Astrology API
  version: 2.0.0
  description: '# RoxyAPI: the Spiritual OS layer for agentic AI


    > **Base URL:** `https://roxyapi.com/api/v2`.'
  x-error-codes:
  - code: validation_error
    status: 400
    meaning: A field is missing or invalid. The body lists every failing field at once in issues, each with its path and the expected shape.
  - code: bad_request
    status: 400
    meaning: The request was rejected as a whole, for example a body that is not valid JSON or a date range that ends before it starts.
  - code: date_out_of_range
    status: 400
    meaning: A date lies outside the span the planetary positions are served for. The error names the supported dates.
  - code: api_key_required
    status: 401
    meaning: No API key was sent.
  - code: invalid_api_key
    status: 401
    meaning: The key sent is malformed or cannot be verified.
  - code: api_key_revoked
    status: 401
    meaning: The key was valid once and has since been revoked from the account page.
  - code: subscription_not_found
    status: 401
    meaning: The key verifies, but the subscription behind it no longer exists.
  - code: subscription_inactive
    status: 401
    meaning: The subscription behind the key is cancelled, expired or suspended, or a trial is past its end date.
  - code: publishable_key_not_allowed_on_mcp
    status: 401
    meaning: A publishable key was used on a Remote MCP server, which takes a secret key.
  - code: invalid_client_ip
    status: 401
    meaning: A keyless request could not be attributed to a caller.
  - code: unauthorized
    status: 401
    meaning: Authentication failed with no more specific reason to give.
  - code: forbidden
    status: 403
    meaning: The key is valid, but this request is not permitted.
  - code: origin_required
    status: 403
    meaning: A publishable key with an origin allowlist was used with no Origin header, as from a server or a native app.
  - code: origin_not_allowed
    status: 403
    meaning: The calling site is not on the origin allowlist of this publishable key.
  - code: not_found
    status: 404
    meaning: Nothing is served at this path, or the identifier in it does not exist. A path miss adds suggestions, the closest real endpoints.
  - code: method_not_allowed
    status: 405
    meaning: The path exists for a different HTTP method. The body lists the accepted methods in allow, as does the Allow header.
  - code: conflict
    status: 409
    meaning: The request cannot be applied in the current state.
  - code: gone
    status: 410
    meaning: The path was removed permanently.
  - code: payload_too_large
    status: 413
    meaning: The request body is larger than the API accepts.
  - code: unsupported_media_type
    status: 415
    meaning: 'A request with a body was sent without Content-Type: application/json.'
  - code: unprocessable_entity
    status: 422
    meaning: Every field is valid, but the combination cannot be computed.
  - code: rate_limit_exceeded
    status: 429
    meaning: The monthly request allowance is used up. Retry-After gives the seconds to the reset.
  - code: rate_limit_per_minute
    status: 429
    meaning: The per-minute limit of the plan was reached. Retry-After gives the seconds to the next minute, and the monthly allowance is not charged.
  - code: rate_limited
    status: 429
    meaning: A rate limit was reached, reported without the plan detail.
  - code: free_tier_exhausted
    status: 429
    meaning: A keyless request has used up its trial allowance.
  - code: internal_error
    status: 500
    meaning: The request failed inside our service. Retry with exponential backoff.
  - code: compute_saturated
    status: 503
    meaning: Heavy calculations are briefly at capacity. Send the same request again after Retry-After seconds.
  - code: error
    status: null
    meaning: A fallback for a status with no more specific code. The status and the error field carry the signal.
  contact:
    name: RoxyAPI Support
    url: https://roxyapi.com/contact
  license:
    name: Proprietary
    url: https://roxyapi.com/policy/terms
servers:
- url: https://roxyapi.com/api/v2
  description: Production API v2
security:
- apiKey: []
tags:


# --- truncated at 32 KB (886 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/roxyapi/refs/heads/main/openapi/roxyapi-western-astrology-api-openapi.yml