Download the PHP package roxyapi/sdk without Composer
On this page you can find all versions of the php package roxyapi/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package sdk
Short Description Official PHP SDK for RoxyAPI: Western and Vedic astrology, numerology, tarot, biorhythm, I Ching, crystals, dreams, angel numbers, location, usage, and languages.
License MIT
Homepage https://roxyapi.com
Informations about the package sdk
roxyapi/sdk
Official PHP SDK for RoxyAPI: Western and Vedic astrology, Human Design, forecast timelines, numerology, tarot, biorhythm, I Ching, crystals, dreams, angel numbers, location geocoding, and more. 148 endpoints across 12 domains, one API key, one dependency (Saloon).
Install
Requires PHP 8.2+.
Quick start
Get an API key at roxyapi.com/pricing. All endpoints take an API key via the X-API-Key header (set automatically by the SDK).
What is exposed
createRoxy($apiKey) returns a Roxy connector that lazy-loads one resource per OpenAPI tag:
| Property | Endpoints | What it covers |
|---|---|---|
$roxy->astrology |
23 | Production-ready Western astrology API + remote MCP for AI agents and developers |
$roxy->vedicAstrology |
43 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
$roxy->numerology |
16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
$roxy->tarot |
10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
$roxy->humanDesign |
12 | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
$roxy->forecast |
5 | Merge upcoming transit aspects, sign ingresses, retrograde stations, Vimshottari dasha changes, and biorhythm critica... |
$roxy->biorhythm |
6 | The most complete biorhythm API + remote MCP for AI agents and developers |
$roxy->iching |
9 | I-Ching oracle API + hosted MCP for AI agents and developers |
$roxy->crystals |
12 | Production-ready crystal healing API + hosted MCP for AI agents and developers |
$roxy->dreams |
5 | Dream interpretation API + hosted MCP for AI agents and developers |
$roxy->angelNumbers |
4 | Production-ready angel numbers API + hosted MCP for AI agents and developers |
$roxy->location |
3 | City search and geocoding API + hosted MCP for AI agents and astrology apps |
$roxy->usage |
1 | Monitor your API usage, check rate limits, and track request consumption |
$roxy->languages |
1 | List the response languages accepted by the lang query parameter on every i18n-aware endpoint |
Every method returns array<string, mixed> decoded from JSON, or throws RoxyAPI\Sdk\RoxyApiException on 4xx/5xx.
Error handling
Stable codes: validation_error, api_key_required, invalid_api_key, subscription_inactive, not_found, rate_limit_exceeded, internal_error.
Multi-language responses
Pass lang (ISO 639-1) on supported endpoints. Defaults to English. Eight languages: en, tr, de, es, fr, hi, pt, ru.
$roxy->languages->listLanguages() returns the canonical list at runtime.
Rendering with @roxyapi/ui
This SDK fetches JSON. For HTML rendering, hand the JSON to @roxyapi/ui web components in the browser.
examples/render-with-ui.html shows the full pattern: PHP endpoint backed by the SDK, browser fetches JSON and assigns it to a <roxy-natal-chart> element. No PHP-side templating.
Testing your integration
Saloon's MockClient lets you mock requests by class:
Examples
examples/vanilla-php.php- raw PHP, prints a horoscopeexamples/laravel.php- Laravel service provider snippetexamples/human-design.php- full Human Design bodygraph, prints type, strategy, and profileexamples/forecast.php- cross-domain forecast timeline, prints the event count and a sample eventexamples/render-with-ui.html- server-side fetch + browser render via@roxyapi/ui
Documentation
- API reference: https://roxyapi.com/api-reference
- Agent guide (
AGENTS.md): bundled in the package, optimised for AI coding agents - MCP setup for AI agents: https://roxyapi.com/docs/mcp
- Sibling SDKs: TypeScript, Python
License
MIT