Jewellery and gemstones
Recommend the stone, and show the reason
From a birth date, time and place, the API suggests the traditional gemstone and its substitutes, the metal, the finger and the day, and the chart reasoning behind them. Add a branded report to send, and a rudraksha suggestion with its reasons.
Free trial with 5,000 credits, no card required
The problem
What a gemstone brand has to solve
A customer trusts a stone more when the shop can say why it was chosen.
- 01A recommendation with no reasonA bare "wear a ruby" is easy to doubt. The response names the lagna, its lord and where it sits, which is the traditional basis.
- 02A counter that needs an answer in a minuteAt the shop, staff enter a date, time and place and read the answer on a tablet.
- 03Alternatives at every priceSubstitutes and uparatna come with the main stone, so a customer can choose within a budget.
- 04Something to take homeA branded report with the recommendation, as a PDF, carries your name.
- 05Customers in their own languageResults answer in 25 languages besides English on supported capabilities.
- 06No overclaimingGemstone astrology is a traditional practice. The API presents it as such, with cautions, and makes no promise of results.
What you can build
The tools a gemstone brand ships
- 10 creditsPrediction Report: Gem recommendationPredictions & readingsA "find your stone" result from the chart: primary stone, substitutes, uparatna, metal, finger, day and mantra, with the lagna reasoning.See the endpoint
- 1 creditGemstone DetailsRemedies & guidanceA product page entry for one planet's stone: colour, metal, finger, day, nakshatras and signs.See the endpoint
- 1 creditGemstone CatalogueRemedies & guidanceThe whole gemstone catalogue, for an educational page or a product filter.See the endpoint
- 1 creditRudraksha RecommendationRemedies & guidanceA rudraksha suggestion from the lagna, Moon sign, dasha lord and weak planets, with the reasons.See the endpoint
- 1 creditRadical (Psychic) NumberNumerologyA number-based suggestion that needs only a date of birth.See the endpoint
- 1 creditPuja SuggestionRemedies & guidanceA puja suggestion to offer alongside a stone.See the endpoint
- 1 creditMantra LibraryRemedies & guidanceMantras to print on a card or a leaflet.See the endpoint
Stones with the reason
Show the chart reasoning next to the stone
The gem recommendation names the lagna and its lord, the house the lord sits in and its condition, then the primary stone, the substitutes, the metal, the finger and the day. Your page can show the reason as well as the answer.
- The basis, statedLagna, lagna lord, its house and its condition are in the response.
- Substitutes and uparatnaOffer a choice that fits a customer's budget.
- CautionsThe details endpoint lists traditional cautions with each stone.

How it works
From the counter to a take-home report
Connect a customer's birth details to a traditional recommendation and explain the reasoning alongside the stone.
Enter the customer's birth details
Send the local date and time, an IANA time zone and the place's coordinates. The answer names the stone and the basis for it.
Add a rudraksha suggestion
Send the lagna, Moon and Sun signs and the weak planet to get a suggestion with the reasons.
Fill the product page for a stone
Look up a planet's stone for the catalogue page, with its colour, metal, finger, day, nakshatras and signs.
To send a take-home report, ask for the report as a PDF with your brand: see the PDF API.
Read the integration guideA report with your name on it
A branded report to take home
Turn the recommendation into a PDF with your logo, colours and footer, and hand it over at the counter or send it by email. A narrated audio version is available too.
- PDF jobsA report as a PDF costs 120 credits on top of the report.
- Your brandYour name, colour, footer and website on every page.
- AudioAny report can be narrated: see audio reports.

What it costs
Typical monthly workloads, priced from the live price book
A typical month
1,000 customers get a stone and a rudraksha suggestion
11,000 credits a month
Calls and credits for 1,000 customers get a stone and a rudraksha suggestion Call Calls Credits Gem recommendation10 credits a call 1,000 10,000 Rudraksha suggestion1 credit a call 1,000 1,000 The smallest plan that covers it:
Custom Orbit
₹849 or $12 a month, with 20,000 credits.
One call each per customer.
A typical month
A product catalogue refreshed monthly
10 credits a month
Calls and credits for A product catalogue refreshed monthly Call Calls Credits Gemstone catalogue1 credit a call 1 1 One entry per planet1 credit a call 9 9 The smallest plan that covers it:
Orbit Remedies & guidance, Base
₹349 or $5 a month, with 15,000 credits.
Fetch once and store.
Assumes one call per customer and the result stored. A PDF adds 120 credits to a report. Sandbox keys cost nothing.
See all plans and pricesAlso in the box
Languages, widgets, SDKs and PDF
More ways to put it in front of customers.
Trust
Accurate, and clear about how data is handled
- 2,056 of 2,062 values agreeChecked against independent references on 27 test charts and 6 matching pairs, each within its stated tolerance. See the method and every check.
- What happens to the birth data you sendWe process request data only to compute your result and do not use it for anything else. Usage records keep the capability called, status, timing, credits and a one-way fingerprint of the request, not the request body. See the privacy policy.
- Support response timesFirst response by plan: Orbit, Constellations and Custom Orbit within 2 business days; Cosmos Rise and Zenith within 1 business day; Cosmos Apex within 8 business hours in a priority queue. Business hours are Monday to Friday, 10:00 to 18:00 IST. See the service levels.
- Uptime and statusOrbit, Constellations and Custom Orbit target 99.5% monthly uptime and Cosmos 99.9%, with service credits if a target is missed. The status page shows live health and incident history.
FAQ
Questions
01How is a stone chosen?+
The recommendation follows the traditional method: it starts from the lagna and its lord, where the lord sits and its condition. The response states that basis, so you can show it.
02What if a customer has no birth time?+
The number-based suggestion needs only a date of birth. A chart-based one needs the time, as it depends on the ascendant.
03Do you promise results from a stone?+
No. Gemstone astrology is a traditional practice. The API returns the traditional recommendation and cautions and makes no promise of any outcome. Do not present it as medical or financial advice.
04Can I show substitutes for a smaller budget?+
Yes. The recommendation lists substitutes and uparatna with the primary stone.
05Can I put my brand on the report?+
Yes. A report can be made as a PDF with your logo, colours and footer. See the PDF API.
06Can I use it at a shop counter?+
Yes. Your tablet app calls your backend with the birth details, and your backend calls the API.
07Which languages are supported?+
AI readings can be written in 26 languages (English and 25 more), and most calculations and reports also answer in those 25 languages: send language with an ISO 639-1 code. The text is machine-written and has not been reviewed by native speakers. Field names and values never change with language. See languages.
08Do you keep the birth details I send?+
We process request data only to compute your result and do not use it for anything else, and we do not use API data to train AI models. Usage records do not keep the request body. A result may be held in memory for up to 15 minutes so an identical request is answered faster. The privacy policy has the exact wording.
09Can I try it before paying?+
Yes. Create an account for the free trial (5,000 credits, no card needed). Sandbox keys are free and answer every endpoint, so you can build the whole integration before you spend a credit. After the trial the free Spark plan keeps a small monthly allowance. See pricing.
Give every stone a reason
Create a free key and try the gem recommendation in the sandbox.


