Endpoint access by tier
This page details which API endpoints each tier unlocks, rate limits, and monthly meter allowances.
Access is organized around two surfaces and 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.
Visit the Billing page to view current pricing and subscribe.
Endpoint matrix
The following table maps each endpoint to its surface and meter.
| 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 |
Bodygraph SVG (/api/chart/bodygraph.svg) | Chart API | Chart requests |
Bodygraph PNG (/api/chart/bodygraph.png) | Chart API | Chart requests |
Astrology Wheel SVG (/api/astrology/wheel.svg) | Chart API | Chart requests |
Astrology Wheel PNG (/api/astrology/wheel.png) | 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. Every key includes a Free floor. The following numbers show what a paid tier adds.
| Tier | Price | Chart requests / mo | SAGE responses / mo | Rate limit | MCP scope | Cap behavior |
|---|---|---|---|---|---|---|
| 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 not a separate signup. Every key includes at least 100 chart requests and 25 SAGE responses per month. Paid tiers add their allowance on top of this floor. A Chart subscriber keeps the 25 SAGE responses from the Free floor.
Subscriptions stack and allowances add. You can hold up to 3 active subscriptions per product. Adding a plan only grows your access.
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).
Advanced and Pro cover both Chart requests and SAGE responses on a single key. If you only need one surface, the Chart and SAGE tiers are cheaper. You can add the other later.