The .NET SDK for astrology, Vedic astrology, numerology, tarot, and more.
One API key. Fully typed. Verified against NASA JPL Horizons.
The fastest way to add natal charts, daily horoscopes, synastry, Vedic kundli, tarot spreads, numerology, human design bodygraphs, and transit forecasts to ASP.NET Core, Blazor, MAUI, Unity, and AI agents. 12+ domains behind a single Roxy subscription, interpretations in eight languages, generated from the OpenAPI spec so new endpoints appear the day they ship.
dotnet add package RoxyApi.SdkOr add it to your project file:
<PackageReferenceInclude="RoxyApi.Sdk"Version="*" />Targets netstandard2.0 and net8.0, so it runs on .NET 8 and later, .NET Framework 4.6.1 and later, Unity, and Mono.
Get real product value with a single typed call. No setup beyond your API key.
usingRoxyApi;varroxy=newRoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);varhoroscope=awaitroxy.Astrology.Horoscope["aries"].Daily.GetAsync();Console.WriteLine($"{horoscope!.Overview}\n{horoscope.Love}\nLucky number: {horoscope.LuckyNumber}");Then expand into charts, compatibility, numerology, tarot, and more.
usingRoxyApi;usingRoxyApi.Models;usingMicrosoft.Kiota.Abstractions;// for the Date typevarroxy=newRoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);// Step 1: geocode the birth city (required for any chart endpoint).varsearch=awaitroxy.Location.Search.GetAsync(c =>c.QueryParameters.Q="London, UK");varcity=search!.Cities![0];// Step 2: Western natal chart. Pass the IANA timezone string and the server// resolves it to the DST-correct offset for the chart's own date.varchart=awaitroxy.Astrology.NatalChart.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=city.Latitude,Longitude=city.Longitude,Timezone=new(){String=city.Timezone},});// Vedic kundli takes the same inputs (timezone optional, defaults to 5.5 IST).varkundli=awaitroxy.VedicAstrology.BirthChart.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=city.Latitude,Longitude=city.Longitude,Timezone=new(){String=city.Timezone},});new RoxyClient(apiKey) sets the base URL (https://roxyapi.com/api/v2) and injects the auth header and SDK identification header on every request.
These are the only .NET-specific shapes worth learning. The rest is plain typed objects.
- Dates and times use typed structs.
Date = new Date(1990, 1, 15)andTime = new Time(14, 30, 0), both fromMicrosoft.Kiota.Abstractions. Timezoneis a typed union. Pass a decimal offset withnew() { Double = -5 }or an IANA name withnew() { String = "America/New_York" }. The server resolves an IANA name to the DST-correct offset for the request date.- Query parameters use a configuration lambda.
await roxy.Crystals.Search.GetAsync(c => c.QueryParameters.Q = "amethyst");
Every chart, horoscope, panchang, dasha, dosha, navamsa, KP, synastry, compatibility, and natal endpoint needs Latitude, Longitude, and (for Western) Timezone. Never ask users to type coordinates. Call roxy.Location.Search first, then feed the result into the chart method.
varsearch=awaitroxy.Location.Search.GetAsync(c =>c.QueryParameters.Q="Tokyo");varcity=search!.Cities![0];// city.Timezone is the IANA string ("Asia/Tokyo"). Pass it straight into any chart// endpoint. city.UtcOffset (a decimal like 9 or 5.5) also works.Q accepts a bare city ("Paris"), city plus country ("Berlin Germany"), or comma-qualified ("Springfield, Illinois"). Use the qualified form to disambiguate same-named cities.
Type roxy. to see every domain. Type roxy.Astrology. to see every endpoint in that domain.
| Accessor | What it covers |
|---|---|
roxy.Astrology | Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, syn... |
roxy.VedicAstrology | Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan ku... |
roxy.Forecast | Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm... |
roxy.HumanDesign | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
roxy.Numerology | Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch... |
roxy.Tarot | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
roxy.Biorhythm | The most complete biorhythm API: 10 cycle types across 3 primary (physical, emotional, intellectual), 4 secondary (in... |
roxy.Iching | I-Ching oracle API with all 64 hexagrams, 384 changing lines, 8 trigrams, and modern interpretations for love, career... |
roxy.Crystals | Crystal healing API covering the most popular and widely-searched healing crystals and gemstones, from Amethyst and R... |
roxy.Dreams | Dream interpretation API with a 2,000+ symbol dream dictionary and psychological meanings covering animals, objects,... |
roxy.AngelNumbers | Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering eve... |
roxy.Location | Location and timezone API with city search and geocoding across 235,000+ cities in 240+ countries, returning latitude... |
roxy.Usage | Monitor your API usage, check rate limits, and track request consumption |
roxy.Languages | List the response languages accepted by the lang query parameter on every i18n-aware endpoint |
The highest-demand endpoints by domain, in the order you are most likely to ship them. Full endpoint catalog in the API reference, complete method list in docs/llms-full.txt.
The global astrology app market is $6.27B and almost entirely Western. These endpoints power zodiac dating apps, Co-Star-style natal chart products, daily horoscope features, and lunar-cycle wellness apps.
// Natal chart. The number-one Western query, called on every onboarding.varnatal=awaitroxy.Astrology.NatalChart.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=40.7128,Longitude=-74.006,Timezone=new(){Double=-5},});// Daily horoscope. Highest per-user call frequency in the catalog, drives DAUs and push.varhoroscope=awaitroxy.Astrology.Horoscope["aries"].Daily.GetAsync();// horoscope.Overview, horoscope.Love, horoscope.Career, horoscope.LuckyNumber// Synastry. The dating-app pro-tier feature, full inter-aspect analysis between two charts.varsynastry=awaitroxy.Astrology.Synastry.PostAsync(new(){Person1=new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=40.7128,Longitude=-74.006,Timezone=new(){Double=-5}},Person2=new(){Date=newDate(1992,7,22),Time=newTime(9,0,0),Latitude=51.5074,Longitude=-0.1278,Timezone=new(){Double=1}},});// Moon phase. Viral for wellness, cycle-tracking, and meditation apps.varmoon=awaitroxy.Astrology.MoonPhase.Current.GetAsync();The depth moat. India astrology market: $163M in 2024, projected $1.8B by 2030. Kundli, panchang, dasha, dosha, and KP are the five Google-dominant queries for every matrimonial platform, kundli generator, and muhurat app.
// Vedic kundli. Top India astrology keyword. Entry point for every Jyotish product.varkundli=awaitroxy.VedicAstrology.BirthChart.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=28.6139,Longitude=77.209,Timezone=new(){Double=5.5},});// Panchang. Tithi, nakshatra, yoga, karana, rahu kaal, abhijit muhurta in one call.varpanchang=awaitroxy.VedicAstrology.Panchang.Detailed.PostAsync(new(){Date=newDate(2026,4,22),Latitude=28.6139,Longitude=77.209,Timezone=new(){Double=5.5},});// Vimshottari dasha. Highest-value single-shot Vedic query.vardasha=awaitroxy.VedicAstrology.Dasha.Current.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=28.6139,Longitude=77.209,Timezone=new(){Double=5.5},});// Mangal Dosha. Most-asked matrimonial question in India.varmanglik=awaitroxy.VedicAstrology.Dosha.Manglik.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=28.6139,Longitude=77.209,Timezone=new(){Double=5.5},});// Guna Milan. 36-point Ashtakoota matrimonial compatibility score.varmilan=awaitroxy.VedicAstrology.Compatibility.PostAsync(new(){Person1=new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=28.61,Longitude=77.20,Timezone=new(){Double=5.5}},Person2=new(){Date=newDate(1992,7,22),Time=newTime(9,0,0),Latitude=19.07,Longitude=72.87,Timezone=new(){Double=5.5}},});// KP ruling planets. Horary answers for "will X happen" questions in real time.varkp=awaitroxy.VedicAstrology.Kp.RulingPlanets.PostAsync(new(){Latitude=28.6139,Longitude=77.209,Timezone=new(){Double=5.5},Datetime=DateTimeOffset.Parse("2026-04-22T10:30:00Z"),});Commodity content with durable demand. life path number calculator is among the highest-volume spiritual searches globally. Works without birth time, the easiest domain to integrate.
// Life Path. The number-one numerology keyword, every calculator page starts here.varlifePath=awaitroxy.Numerology.LifePath.PostAsync(new(){Year=1990,Month=1,Day=15});// lifePath.Number, lifePath.Type ("single" or "master"), lifePath.Meaning// Full numerology chart. Premium one-shot: all core numbers plus karmic and personal year.varchart=awaitroxy.Numerology.Chart.PostAsync(new(){FullName="Jane Smith",Year=1990,Month=1,Day=15,});// Personal Year. Annual forecast, drives January traffic spikes.varpersonalYear=awaitroxy.Numerology.PersonalYear.PostAsync(new(){Month=1,Day=15,Year=2026});High search volume, evergreen. Apps fetch the card database once and cache it, then draw on demand.
// Daily card. Stickiest tarot feature. Seed per user for deterministic once-per-day behavior.vardaily=awaitroxy.Tarot.Daily.PostAsync(new(){Seed="user-42"});// daily.Card.Name, daily.Card.ImageUrl, daily.DailyMessage// Celtic Cross. Professional-reader spread. Premium-tier, ten positions.varceltic=awaitroxy.Tarot.Spreads.CelticCross.PostAsync(new(){Question="What should I focus on?"});// Three-card past-present-future. Most-drawn spread on every tarot platform.varthree=awaitroxy.Tarot.Spreads.ThreeCard.PostAsync(new(){Question="My next quarter"});// Yes / No. Impulse micro-query, highest conversion-to-first-call on tarot surfaces.varanswer=awaitroxy.Tarot.YesNo.PostAsync(new(){Question="Should I take the offer?"});// answer.Answer ("Yes", "No", "Maybe"), answer.StrengthThe breakout 2026 self-discovery category. One call returns the full bodygraph from a birth moment: energy type, strategy, authority, profile, definition, incarnation cross, the nine centers, defined channels, and all gate activations. The Design side is solved on the exact 88-degree solar arc, not approximated as calendar days.
varbodygraph=awaitroxy.HumanDesign.Bodygraph.PostAsync(new(){Date=newDate(1990,7,4),Time=newTime(10,12,0),Latitude=40.7128,Longitude=-74.006,Timezone=new(){Double=-4},});// bodygraph.Type, bodygraph.Strategy, bodygraph.Profile, bodygraph.Definition// bodygraph.Centers, bodygraph.Channels, bodygraph.Gates, bodygraph.IncarnationCrossThe first cross-domain, stateless forecast in the catalog. One call merges Western transit-to-natal aspects, sign ingresses, retrograde stations, Vedic Vimshottari dasha boundaries, and biorhythm critical days into a single significance-scored, time-ordered timeline.
vartimeline=awaitroxy.Forecast.Timeline.PostAsync(new(){BirthData=new(){Date=newDate(1990,7,4),Time=newTime(10,12,0),Latitude=40.7128,Longitude=-74.006,Timezone=new(){Double=-4}},StartDate=newDate(2026,6,1),EndDate=newDate(2026,6,30),});// timeline.Count, timeline.Events[0].Date, timeline.Events[0].Domain, timeline.Events[0].SignificanceZero competition domain. Steady search volume with the top Google result being a static calculator page. Pure land-grab for wellness, productivity, sports, and couples apps.
// Daily biorhythm. Physical, emotional, intellectual, intuitive, plus extended cycles.varbio=awaitroxy.Biorhythm.Daily.PostAsync(new(){Seed="user-1",Date=newDate(2026,4,23)});// Multi-day forecast. Best-day and worst-day planner for calendar and coaching products.varforecast=awaitroxy.Biorhythm.Forecast.PostAsync(new(){BirthDate=newDate(1990,1,15),StartDate=newDate(2026,4,1),EndDate=newDate(2026,4,30),});Meditation apps, decision-making tools, and wisdom chatbots. i ching API and hexagram API are the keywords.
// Cast a reading. Active divination: primary hexagram plus changing lines and transformed hexagram.varreading=awaitroxy.Iching.Cast.GetAsync(c =>c.QueryParameters.Seed="user-42");// reading.Hexagram, reading.ChangingLinePositions, reading.ResultingHexagram// Hexagram catalog. Cache once for all 64 hexagrams.varhexagrams=awaitroxy.Iching.Hexagrams.GetAsync();Crystal retail and metaphysical shops use these to build "crystals for [sign]" and "[chakra] chakra stones" pages.
// By zodiac. Highest-search crystal query pattern.varbySign=awaitroxy.Crystals.Zodiac["scorpio"].GetAsync();// By chakra. Second-highest crystal query pattern.varbyChakra=awaitroxy.Crystals.Chakra["Heart"].GetAsync();// Birthstone by month. Evergreen gift and jewelry SEO.varbirthstone=awaitroxy.Crystals.Birthstone[4].GetAsync();Thousands of dream symbols. dream meaning is among the highest-volume spiritual searches on Google. Journal apps, AI therapy chatbots, and self-discovery products are the buyers.
// Symbol detail. Every "what does it mean to dream about X" page lands here.varsymbol=awaitroxy.Dreams.Symbols["snake"].GetAsync();// symbol.Name, symbol.Meaning// Symbol search. Chatbots cache the dictionary locally after one call.varresults=awaitroxy.Dreams.Symbols.GetAsync(c =>c.QueryParameters.Q="water");Gen Z spiritual-tok fuel. 111 meaning, 222 meaning, 333 angel number are evergreen viral queries with massive shareability.
// By number. Every "meaning of 1111" page is backed by this.varangel=awaitroxy.AngelNumbers.Numbers["1111"].GetAsync();// angel.Meaning.Spiritual, angel.Meaning.Love, angel.Affirmation// Universal lookup. Works for any positive integer via digit-root fallback.varany=awaitroxy.AngelNumbers.Lookup.GetAsync(c =>c.QueryParameters.Number="4242");
This package ships documentation that AI coding agents read directly from the restored NuGet package:
AGENTS.mdfor quick start, patterns, gotchas, and a common-tasks referencedocs/llms-full.txtfor the complete method reference with one example per endpoint
Agents that support AGENTS.md (Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI) pick it up automatically. For other tools, point your agent at the restored package under ~/.nuget/packages/roxyapi.sdk/<version>/.
Prefer MCP? Every domain has a remote MCP server at https://roxyapi.com/mcp/{domain} (Streamable HTTP, no stdio, no self-hosting). One-line Claude Code setup:
claude mcp add-json --scope user roxy-astrology \
'{"type":"http","url":"https://roxyapi.com/mcp/astrology","headers":{"X-API-Key":"YOUR_KEY"}}'Get your API key at roxyapi.com/pricing. Instant delivery after checkout.
varroxy=newRoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);Never expose your API key in a desktop, mobile, browser, or Unity client. Call Roxy from your server, API, or backend only.
For advanced use (a custom HttpClient, a proxy, or your own middleware), build the client with a Kiota request adapter:
usingMicrosoft.Kiota.Http.HttpClientLibrary;varadapter=newHttpClientRequestAdapter(authProvider,httpClient:yourHttpClient);varroxy=newRoxyClient(adapter);Interpretations and editorial text are available in eight languages: English (en), Turkish (tr), German (de), Spanish (es), French (fr), Hindi (hi), Portuguese (pt), Russian (ru). Pass Lang on any supported endpoint through the query configuration:
varcard=awaitroxy.Tarot.Daily.PostAsync(new(){Date=newDate(2026,4,22)},
c =>c.QueryParameters.Lang="es");Supported: astrology, Vedic astrology, numerology, tarot, biorhythm, I Ching, crystals, angel numbers. English-only: dreams, location. Untranslated fields fall back to English. Call roxy.Languages.GetAsync() for the live list.
Every endpoint throws a typed RoxyError (which extends ApiException) on a 4xx or 5xx response. The message is human-readable; switch on Code for programmatic handling.
usingRoxyApi.Models;try{varhoroscope=awaitroxy.Astrology.Horoscope["aries"].Daily.GetAsync();Console.WriteLine(horoscope!.Overview);}catch(RoxyErrore){// e.Code is stable; e.Message may change wording. e.ResponseStatusCode is the HTTP status.// On a 400, e.Issues lists every field that failed validation.Console.WriteLine($"{e.ResponseStatusCode}{e.Code}: {e.Message}");}| Status | Code | When |
|---|---|---|
| 400 | validation_error | Missing or invalid parameters (see Issues) |
| 401 | api_key_required | No API key provided |
| 401 | invalid_api_key | Key format invalid or tampered |
| 401 | subscription_not_found | Key references a non-existent subscription |
| 401 | subscription_inactive | Subscription cancelled, expired, or suspended |
| 404 | not_found | Resource not found |
| 429 | rate_limit_exceeded | Monthly quota reached |
| 500 | internal_error | Server error |
Every response is a fully typed object, so your IDE autocompletes every field. There is no untyped dictionary to guess against. The complete response JSON for every endpoint, with real production data, is on the live API reference playground. You rarely write a response type name yourself: capture results with var and let IntelliSense show the shape (the generated type names such as SearchGetResponse_cities are internal plumbing).
roxy.Location.Search returns Cities, a list where each item has City (the name), Country, Province, Latitude, Longitude, Timezone (IANA string), UtcOffset (decimal), and Population.
varsearch=awaitroxy.Location.Search.GetAsync(c =>c.QueryParameters.Q="London, UK");varcity=search!.Cities![0];Console.WriteLine($"{city.City}, {city.Country} at {city.Latitude}, {city.Longitude} ({city.Timezone})");Planets, Houses, Aspects, Ascendant, Midheaven, PartOfFortune, Patterns, and a Summary. Each planet carries Name, Sign, Degree, House, IsRetrograde, and Speed. The Planets list covers the full set used in modern astrology (the ten classical bodies plus the lunar nodes and key points), so expect more than ten entries.
varchart=awaitroxy.Astrology.NatalChart.PostAsync(new(){Date=newDate(1990,1,15),Time=newTime(14,30,0),Latitude=40.7128,Longitude=-74.006,Timezone=new(){Double=-5},});foreach(varplanetinchart!.Planets!)Console.WriteLine($"{planet.Name}: {planet.Sign}{planet.Degree:F2} (house {planet.House})");They throw. On success a call returns the typed response (a nullable reference, so use ! or a null check after you have handled errors); on a 4xx or 5xx it throws RoxyError. Wrap calls in try/catch (RoxyError e) and switch on e.Code.
.NET 8 and later, plus anything that consumes netstandard2.0: .NET Framework 4.6.1+, Unity, Xamarin, MAUI, and Mono. Language version 12 or later is recommended for the new() and collection-expression syntax in these examples.
- .NET 8 or later, or any runtime supporting
netstandard2.0(.NET Framework 4.6.1+, Unity, Mono). Language version 12 or later is recommended for the collection-expression and target-typednew()syntax shown above. Microsoft.Kiota.Bundleis the only runtime dependency. It pulls in the Kiota HTTP, authentication, and serialization libraries (all MIT licensed, maintained by Microsoft) that power the generated client.
The typed client is generated from the public OpenAPI specification with Kiota, so the SDK stays in lockstep with the API and new endpoints arrive automatically.
- Documentation
- API Reference
- Pricing
- MCP setup for AI agents
- Templates
- TypeScript SDK | Python SDK | PHP SDK
- Issues
MIT