Skip to content

Commit 0e551f6

Browse files
github-actions[bot]github-actions[bot]
committed
release: v0.1.12
1 parent 13bcffe commit 0e551f6

3 files changed

Lines changed: 36 additions & 37 deletions

File tree

‎pyproject.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "uv_build"
44

55
[project]
66
name = "roxy-sdk"
7-
version = "0.1.11"
7+
version = "0.1.12"
88
description = "Python SDK for RoxyAPI. Astrology, tarot, numerology, and more."
99
readme = "README.md"
1010
license = "MIT"

‎specs/openapi.json‎

Lines changed: 34 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@
66
"description": "# RoxyAPI: AI-Native Insight Infrastructure\n\n> **Base URL:** `https://roxyapi.com/api/v2`\n> All endpoint paths below are relative to this base URL.\n\nThe only multi-domain spiritual intelligence API. 10 domains (astrology, tarot, numerology, crystals, dreams, I-Ching, angel numbers, Vedic astrology, location, biorhythm), 130+ endpoints, one API key, instant activation. Native MCP support for AI agents.\n\n## Who uses RoxyAPI\n\n- **Developers** building astrology apps, tarot platforms, numerology calculators, or dream journals\n- **AI agent builders** connecting Claude, GPT, or Gemini to real calculation engines via MCP\n- **Vibe coders** shipping insight apps with Cursor, Bolt, or Replit using zero domain knowledge\n- **Founders and brands** launching branded spiritual experiences for their audience\n\n## Quick start (60 seconds)\n\n**1. Get your API key** at [roxyapi.com/pricing](https://roxyapi.com/pricing). Instant delivery, no account required.\n\n**2. Make your first call:**\n```bash\ncurl -H \"X-API-Key: YOUR_KEY\" https://roxyapi.com/api/v2/tarot/draw -X POST -H \"Content-Type: application/json\" -d '{\"count\": 3}'\n```\n\n**3. Monitor usage:**\n```bash\ncurl -H \"X-API-Key: YOUR_KEY\" https://roxyapi.com/api/v2/usage\n```\n\n## AI agent integration (MCP)\n\nRoxyAPI has native Model Context Protocol support. Your AI agent auto-discovers all 130+ endpoints as callable tools with zero configuration:\n- **Claude Desktop, Cursor, Windsurf**: Add MCP server URL in settings\n- **OpenAI Agents, Gemini ADK**: Connect via Streamable HTTP transport\n- **Custom agents**: Use the MCP Python/TypeScript SDK\n\nMCP endpoints: `https://roxyapi.com/mcp/{domain}` (e.g., `/mcp/astrology`, `/mcp/tarot`)\n\nSetup guide: [roxyapi.com/docs/mcp](https://roxyapi.com/docs/mcp)\n\n## Authentication\n\nAll endpoints require an API key via header or query param:\n- **Header (recommended):** `X-API-Key: YOUR_KEY`\n- **Query param (testing):** `?api_key=YOUR_KEY`\n\n## Response format\n\nClean JSON, no wrapper objects. Errors return `{ \"error\": \"message\", \"code\": \"error_code\" }`. The `error` field is human-readable (may change wording). The `code` field is machine-readable (stable \u2014 safe to switch on programmatically).\n\nRate limit headers on every response: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Used`\n\n## Errors\n\nAll errors return `{ \"error\": \"message\", \"code\": \"error_code\" }`:\n\n| Status | Code | When |\n|--------|------|------|\n| 400 | `validation_error` | Missing or invalid parameters. Response includes `issues[]` with per-field `path`, `message`, `code`, `expected`, `minimum`, `maximum`, `format`, `pattern`. |\n| 401 | `api_key_required` | No API key provided |\n| 401 | `invalid_api_key` | Key format invalid or tampered |\n| 401 | `subscription_not_found` | Key references non-existent subscription |\n| 401 | `subscription_inactive` | Subscription cancelled, expired, or suspended |\n| 404 | `not_found` | Resource not found. Response may include `suggestion`, `hint`, or `availableEndpoints` for typo recovery. |\n| 405 | `method_not_allowed` | Path exists for a different HTTP method. Response includes `allow[]` and the `Allow` header lists valid methods. |\n| 429 | `rate_limit_exceeded` | Monthly quota reached |\n| 500 | `internal_error` | Server error |\n\n## Pricing\n\nFlat per-request pricing. Every call counts the same, whether a planet position or a full birth chart with aspects. No credit systems, no variable costs. Plans from $39 to $699/month.\n\nSee [roxyapi.com/pricing](https://roxyapi.com/pricing)\n\n## Resources\n\n- [Quickstart guide](https://roxyapi.com/docs/quickstart) - first API call in 60 seconds\n- [Documentation](https://roxyapi.com/docs) - guides, tutorials, domain reference\n- [MCP setup](https://roxyapi.com/docs/mcp) - connect AI agents\n- [Starter apps](https://roxyapi.com/starters) - clone and deploy in 30 minutes\n- [FAQ](https://roxyapi.com/faq) - common questions\n- [Contact](https://roxyapi.com/contact) - support and API key recovery\n",
77
"contact": {
88
"name": "RoxyAPI Support",
9-
"email": "hello@roxyapi.com",
109
"url": "https://roxyapi.com/contact"
1110
},
1211
"license": {
@@ -48020,24 +48019,24 @@
4802048019
"schema": {
4802148020
"type": "string",
4802248021
"enum": [
48023-
"Aries",
48024-
"Taurus",
48025-
"Gemini",
48026-
"Cancer",
48027-
"Leo",
48028-
"Virgo",
48029-
"Libra",
48030-
"Scorpio",
48031-
"Sagittarius",
48032-
"Capricorn",
48033-
"Aquarius",
48034-
"Pisces"
48022+
"aries",
48023+
"taurus",
48024+
"gemini",
48025+
"cancer",
48026+
"leo",
48027+
"virgo",
48028+
"libra",
48029+
"scorpio",
48030+
"sagittarius",
48031+
"capricorn",
48032+
"aquarius",
48033+
"pisces"
4803548034
],
48036-
"example": "Pisces",
48037-
"description": "Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces."
48035+
"example": "pisces",
48036+
"description": "Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces."
4803848037
},
4803948038
"required": true,
48040-
"description": "Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces.",
48039+
"description": "Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.",
4804148040
"name": "sign",
4804248041
"in": "path"
4804348042
},
@@ -51347,35 +51346,35 @@
5134751346
"Crown"
5134851347
],
5134951348
"example": "Heart",
51350-
"description": "Filter by chakra association. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown."
51349+
"description": "Filter by chakra association, case-insensitive. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown."
5135151350
},
5135251351
"required": false,
51353-
"description": "Filter by chakra association. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.",
51352+
"description": "Filter by chakra association, case-insensitive. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.",
5135451353
"name": "chakra",
5135551354
"in": "query"
5135651355
},
5135751356
{
5135851357
"schema": {
5135951358
"type": "string",
5136051359
"enum": [
51361-
"Aries",
51362-
"Taurus",
51363-
"Gemini",
51364-
"Cancer",
51365-
"Leo",
51366-
"Virgo",
51367-
"Libra",
51368-
"Scorpio",
51369-
"Sagittarius",
51370-
"Capricorn",
51371-
"Aquarius",
51372-
"Pisces"
51360+
"aries",
51361+
"taurus",
51362+
"gemini",
51363+
"cancer",
51364+
"leo",
51365+
"virgo",
51366+
"libra",
51367+
"scorpio",
51368+
"sagittarius",
51369+
"capricorn",
51370+
"aquarius",
51371+
"pisces"
5137351372
],
51374-
"example": "Pisces",
51375-
"description": "Filter by zodiac sign. Valid values: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces."
51373+
"example": "pisces",
51374+
"description": "Filter by zodiac sign, case-insensitive. Valid values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces."
5137651375
},
5137751376
"required": false,
51378-
"description": "Filter by zodiac sign. Valid values: Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces.",
51377+
"description": "Filter by zodiac sign, case-insensitive. Valid values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.",
5137951378
"name": "zodiac",
5138051379
"in": "query"
5138151380
},
@@ -51390,10 +51389,10 @@
5139051389
"Storm"
5139151390
],
5139251391
"example": "Water",
51393-
"description": "Filter by elemental association. Valid values: Earth, Water, Fire, Air, Storm."
51392+
"description": "Filter by elemental association, case-insensitive. Valid values: Earth, Water, Fire, Air, Storm."
5139451393
},
5139551394
"required": false,
51396-
"description": "Filter by elemental association. Valid values: Earth, Water, Fire, Air, Storm.",
51395+
"description": "Filter by elemental association, case-insensitive. Valid values: Earth, Water, Fire, Air, Storm.",
5139751396
"name": "element",
5139851397
"in": "query"
5139951398
},

‎src/roxy_sdk/version.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
VERSION = "0.1.11"
1+
VERSION = "0.1.12"

0 commit comments

Comments
 (0)