Skip to content

Modules ​

AstroAPI features are organized into modules. Each module unlocks specific API endpoints and functionality for your organization.

Module Categories ​

CategoryDescription
calcCalculation modules — API computation endpoints
textsContent/interpretation text modules
chartsChart rendering modules
addonAdd-on features
adminAdmin/management tools

Available Modules ​

Module IDCategoryDescription
module:natalcalc + texts + chartsNatal chart calculations, interpretations, and chart rendering
module:natal-calccalcNatal chart calculations only
module:synastrycalc + texts + chartsSynastry calculations, interpretations, and charts
module:synastry-calccalcSynastry calculations only
module:transitcalc + texts + chartsTransit calculations, interpretations, and charts
module:transit-calccalcTransit calculations only
module:compositecalc + texts + chartsComposite chart calculations, interpretations, and charts
module:composite-calccalcComposite calculations only
module:progressioncalcSecondary progressions
module:solar-returncalc + texts + chartsSolar return with interpretations and charts
module:solar-return-calccalcSolar return calculations only
module:lunar-returncalc + texts + chartsLunar return with interpretations and charts
module:lunar-return-calccalcLunar return calculations only
module:chinese-horoscopecalcChinese zodiac sign calculation
module:chinese-forecastcalcChinese yearly forecast
module:compatibilitycalcAstrological compatibility
module:mooncalcMoon/Sun calculations and moon calendar
module:retrogradecalcRetrograde period calculations
module:declinationcalcDeclinations, parallels and out-of-bounds detection. Included in every plan; not sold separately
module:numerologycalcNumerology calculations
module:daily-reporttextsDaily horoscope reports
module:weekly-reporttextsWeekly horoscope reports
module:yearly-reporttextsYearly horoscope reports
module:yearly-ascendant-reporttextsYearly ascendant horoscope reports
module:extra-languageaddonAdditional language support
module:ai-addonaddonAI chatbot features
module:embeddable-widgetsaddonEmbeddable widget support
module:content-editoradminContent editor access
module:event-searchcalcSearching the time axis: every date in a window on which something happens, plus a calendar feed. In every plan
module:traditionalcalcHellenistic and traditional technique: sect, dignity, lots, antiscia, profections, zodiacal releasing, firdaria, solar arc. In every plan
module:rectificationcalcRanking candidate birth times against dated life events. In every plan

These three, like declination and sonification, are not sold separately. Every plan carries them and they are priced at zero, so they do not appear in the module listing or in the custom plan builder. None of them is part of the Calculations bundle: that bundle is a flat grant of every :calc permission, which is a different thing from what a plan holds.

Subscription Plans ​

Each subscription plan includes a fixed set of modules. All prices include a 20% discount. "Full" modules include calc + texts + charts. "Calc" modules include calculations only.

FeatureBasic (€49.99/mo)Gold (€112.49/mo)Premium (€249.99/mo)Deluxe (€374.99/mo)
Rate limit60 req/min120 req/min300 req/min600 req/min
Monthly requests150K300K750K1M
Natal (calc)✅✅✅✅
Compatibility✅✅✅✅
Moon/Sun✅✅✅✅
Numerology✅✅✅✅
Declinations✅✅✅✅
Content Editor✅✅✅
Natal (full)✅✅✅
Transit (calc)✅✅
Solar/Lunar Return (calc)✅✅
Synastry/Composite (calc)✅✅
Progressions✅✅
Chinese Horoscope✅✅
Retrograde✅✅
Embeddable Widgets✅✅
Transit (full)✅
Solar/Lunar Return (full)✅
Synastry/Composite (full)✅
Chinese Forecast✅
Daily/Weekly/Yearly Reports✅
Event Search✅✅✅✅
Traditional Astrology✅✅✅✅
Rectification✅✅✅✅

Checking Module Access ​

List all modules available to your organization:

bash
curl -X GET "https://api.astroapi.cloud/api/modules" \
  -H "X-Api-Key: your-api-key"

Response ​

json
{
  "data": [
    {
      "type": "module",
      "id": "module:natal-calc",
      "attributes": {
        "name": "Natal Chart Calculations",
        "enabled": true,
        "expiresAt": null
      }
    },
    {
      "type": "module",
      "id": "module:transit-calc",
      "attributes": {
        "name": "Transit Calculations",
        "enabled": true,
        "expiresAt": "2024-12-31T23:59:59Z"
      }
    }
  ]
}

Module-Gated Endpoints ​

When accessing an endpoint that requires a module you don't have:

json
{
  "errors": [{
    "status": "403",
    "title": "Module Required",
    "detail": "This endpoint requires the 'module:synastry-calc' module.",
    "meta": {
      "requiredModule": "module:synastry-calc"
    }
  }]
}

API Key Permissions ​

API keys can be restricted to specific modules. Even if your organization has access to a module, individual API keys can be scoped to exclude it:

json
{
  "apiKey": {
    "modules": ["module:natal-calc", "module:moon"]
  }
}

This allows you to create limited-scope keys for specific use cases, such as a key that only allows natal chart calculations without access to other modules your organization has subscribed to.

AstroAPI Documentation