Endpoint Access by Tier
A complete reference of which API endpoints each tier unlocks, along with rate limits and the monthly meter allowances that come with each tier.
Access is organised around two surfaces and two public meters:
- Chart API: all chart, composite, astrology, transit, return, retrograde, and multi-chart endpoints. Usage counts against your Chart requests meter.
- SAGE API: the knowledge query endpoint. Usage counts against your SAGE responses meter.
Choosing a tier
Visit the Billing page to view current pricing and subscribe.
Endpoint matrix
Which surface each endpoint belongs to, and the meter it counts against.
| Endpoint | Surface | Meter |
|---|---|---|
Chart (/api/chart) | Chart API | Chart requests |
Composite (/api/composite) | Chart API | Chart requests |
Astrology (/api/astrology) | Chart API | Chart requests |
Transit Chart (/api/transits/chart) | Chart API | Chart requests |
Transit Periods (/api/transits/periods) | Chart API | Chart requests |
All Planets (/api/transits/all) | Chart API | Chart requests |
Moon Range (/api/transits/moon) | Chart API | Chart requests |
Retrogrades (/api/retrogrades) | Chart API | Chart requests |
Returns (/api/returns) | Chart API | Chart requests |
Multi-Chart (/api/multi-chart) | Chart API | Chart requests |
SAGE Query (/api/sage) | SAGE API | SAGE responses |
Location tools (/api/locations, /api/validate-location) | Free with any key | Not metered |
MCP Server (/mcp) | Wraps the above | Same as the wrapped endpoint |
Tier allowances
Each tier unlocks one or both surfaces and includes a monthly allowance on each meter it covers. Every key also carries the Free floor (see below), so the numbers below are what a paid tier adds on top.
| Tier | Price | Chart requests / mo | SAGE responses / mo | Rate limit | MCP scope | Cap behaviour |
|---|---|---|---|---|---|---|
| Free | Free | 100 | 25 | 10 RPM | None | Hard cap |
| Chart | $22/mo · $199/yr | 20,000 | -- | 60 RPM | None | Hard cap |
| SAGE | $29/mo · $299/yr | -- | 3,000 | 100 RPM | SAGE tools | Hard cap |
| Advanced | $44/mo · $399/yr | 40,000 | 4,000 | 120 RPM | Chart + SAGE tools | Soft cap |
| Pro | $100/mo · $899/yr | 100,000 | 10,000 | 300 RPM | Chart + SAGE tools | Soft cap |
| Enterprise | Contact | Unlimited | Unlimited | Custom | Custom | Soft cap |
A hard cap stops requests once the meter is exhausted (the API returns 429). A soft cap keeps serving and reconciles overage on your invoice. SAGE queries run at roughly 100 RPM regardless of tier.
Free is a floor every key gets
Free is not a separate signup. Every key already includes at least 100 chart requests and 25 SAGE responses per month, even before any paid subscription. A paid tier adds its allowance on top of that floor, so a Chart subscriber still keeps the 25 SAGE responses the floor provides.
Tiers stack
Subscribe again and the allowances add. You can hold up to 3 active subscriptions per product, and their chart-request and SAGE-response allowances sum. Adding a plan only ever grows your access. It never shrinks it.
Meter resets
Both meters reset on the first day of each calendar month at 00:00 UTC, regardless of your subscription start date.
Rate limits
Rate limits are enforced per API key on a rolling 60-second window and scale with your tier. Free is 10 RPM, Chart 60 RPM, SAGE 100 RPM, Advanced 120 RPM, Pro 300 RPM, and Enterprise is custom.
When you exceed the rate limit, the API returns a 429 Too Many Requests response. See the Rate Limits page for detailed handling guidance.
Quick reference
- Chart API: all chart, composite, astrology, transit, return, retrograde, and multi-chart endpoints. Unlocked by the Chart, Advanced, and Pro tiers (and the Free floor at 100 requests).
- SAGE API: the knowledge query endpoint and SAGE MCP tools. Unlocked by the SAGE, Advanced, and Pro tiers (and the Free floor at 25 responses).
Run both surfaces
Advanced and Pro cover both Chart requests and SAGE responses on a single key. If you only need one surface, the single-surface Chart and SAGE tiers are cheaper, and you can always add the other later. Subscriptions stack.