Build astrology apps with verified Zodiac ownership.

A verified context layer.

Most astrology apps start with a birth chart. Zodiacs adds another read-only layer: signs that appear in a connected wallet. Apps can surface verified holdings, emphasized elements, wheel coverage, and seasonal relevance inside a reading, profile, or moment.

What apps can build.

Verified held signs become part of familiar astrology surfaces, without custody, signing, or transactions.

Where the SDK fits.

A complete astrology product usually combines several layers. Use an astronomical engine or chart service for natal positions, houses, aspects, transits, and calendars. Add Zodiacs SDK only when the product needs to recognize official Zodiacs and turn public ownership into optional identity context.

Facet copy for app surfaces.

Apps can map verified holdings into aura bars, hover text, or share-card copy without changing the SDK. Treat every facet as optional symbolic context: if this appears, it may emphasize a quality in the experience.

AriesFire · Cardinal

• CourageYou move forward even when the path is not fully clear.
• MomentumYou bring energy that gets things started.
• InitiativeYou are often the first to act when something matters.

TaurusEarth · Fixed

• StabilityYou create calm by staying steady and grounded.
• DevotionYou show care through consistency and presence.
• AbundanceYou notice what is enough and help it grow.

GeminiAir · Mutable

• CuriosityYou stay endlessly interested in how things work.
• WitYou catch patterns quickly and keep the mood alive.
• AdaptabilityYou adjust easily when the situation changes.

CancerWater · Cardinal

• CareYou notice what people need before they say it.
• IntuitionYou often sense the emotional truth underneath the surface.
• ProtectionYou know how to guard what feels tender or important.

LeoFire · Fixed

• RadianceYou bring warmth and visibility into the room.
• ConfidenceYou are learning to take up space without shrinking.
• GenerosityYou share attention, warmth, and creative energy freely.

VirgoEarth · Mutable

• ClarityYou help make confusing things feel clean and workable.
• CraftYou improve things through patience, detail, and care.
• DiscernmentYou can tell what matters and what can be released.

LibraAir · Cardinal

• HarmonyYou sense when something needs balance.
• GraceYou move through tension with tact and beauty.
• DiplomacyYou help different sides find a way to meet.

ScorpioWater · Fixed

• DepthYou are drawn to what is hidden, intense, and real.
• MagnetismYou carry a quiet pull that people can feel.
• PowerYou can transform pressure into inner strength.

SagittariusFire · Mutable

• FreedomYou need space to explore, learn, and expand.
• VisionYou look for meaning beyond the immediate moment.
• FortuneYou notice openings, timing, and possibility.

CapricornEarth · Cardinal

• DisciplineYou keep going when the work asks for patience.
• MasteryYou build confidence through effort and repetition.
• LegacyYou care about what lasts beyond the moment.

AquariusAir · Fixed

• OriginalityYou see things from an angle others might miss.
• InsightYou recognize patterns before they become obvious.
• LiberationYou help break stale patterns and imagine new ones.

PiscesWater · Mutable

• ImaginationYou move easily through dreams, symbols, and possibility.
• CompassionYou feel deeply and respond with care.
• MysticismYou are comfortable with mystery and unseen meaning.

Official Zodiac icons.

The SDK includes icons for all twelve Zodiacs, ready for products that display verified signs in the Zodiacs.org visual language.

Aries

Taurus

Gemini

Cancer

Leo

Virgo

Libra

Scorpio

Sagittarius

Capricorn

Aquarius

Pisces

Use the icons in Zodiac shelves, identity receipts, birth chart overlays, compatibility cards, seasonal moments, profiles, symbolic resonance displays, and AI astrology interfaces.

import { getZodiacIconAsset } from "@zodiacs/sdk/assets";

const leo = getZodiacIconAsset("leo");

console.log(leo.packagePath);
// "@zodiacs/sdk/assets/zodiac-icons/circle/leo.png"

From public address to app surface.

Install the SDK.

Use the package for the official registry, address verification, read-only ownership, identity context, and Zodiac icon assets.

npm i @zodiacs/sdk

Integration paths.

Start with address verification, provenance, public ownership, and identity context.

import {
  getRepresentationByAddress
} from "@zodiacs/sdk/core";

const representation = getRepresentationByAddress(
  "0x3ffB5282F5891Dd8c813E64059EdB0607537eC91"
);

console.log(representation?.sign);  // "aries"
console.log(representation?.chain); // "base"
console.log(representation?.kind);  // "bridged"

import { getCrossChainZodiacsOwnership } from "@zodiacs/sdk";
import { mergeZodiacsOwnership } from "@zodiacs/sdk/identity";

const ownership = await getCrossChainZodiacsOwnership({
  solana: { ownerAddress: solanaOwner, connection },
  base: { ownerAddress: baseOwner, publicClient }
});
const shelf = mergeZodiacsOwnership(ownership);

console.log(shelf.heldSigns);

import {
  getIdentityReceiptData,
  getZodiacIdentityContext
} from "@zodiacs/sdk/identity";

const context = getZodiacIdentityContext(ownership, {
  sunSign: "leo"
});
const receipt = getIdentityReceiptData(ownership);

console.log(context.heldSigns);
console.log(context.elementComposition);
console.log(context.currentSeasonHeld);
console.log(receipt.wheelCoverage);

Give a model facts, not folklore.

An astrology assistant can receive held signs, element and modality composition, wheel coverage, confirmed absent signs, and the current season match. Keep that ownership context separate from the birth chart, include it only when the person opts in, and present it as a symbolic layer rather than proof of character or compatibility.

import { getZodiacIdentityContext } from "@zodiacs/sdk/identity";

const identity = getZodiacIdentityContext(ownership, {
  sunSign: "leo"
});

const promptContext = {
  heldSigns: identity.heldSigns,
  elementComposition: identity.elementComposition,
  currentSeasonHeld: identity.currentSeasonHeld,
  framing: "Optional carried-sign context beside the birth chart"
};

From verified signs to a shareable Aura.

The bundled Simastry Aura example shows one complete product path: read public ownership, compute held-sign context, render it beside a birth-chart sign, and prepare a transparent payload for a share page or an opted-in AI astrologist conversation.

Facts for identity surfaces.

The SDK computes symbolic context from verified public ownership. The source data stays factual, repeatable, and ready to render: held signs, wheel coverage, element and modality composition, and whether the current Zodiac season appears in the shelf.

Styled component preview IdentityReceiptCard

SDK input getIdentityReceiptData(ownership)

Verify address getRepresentationByAddress(address)

Address

Verification Loading official registry... Read-only local check

Aries

Gemini

Leo

Pisces

Sample identity receipt

A public Zodiac shelf.

Held signs 4 of 12

Wheel coverage 33.33%

Element mix Fire · Air · Water

Season Represented

Native 2 Solana

Bridged 2 Base

Aries Gemini Leo Pisces 8 confirmed absent

Copy receipt data

Core SDK surfaces.

The package is organized around registry facts, representation provenance, public reads, identity composition, React helpers, and official display assets.

One related experience, one neutral SDK.

Astrofolio is a related consumer project built around personal Zodiac shelves, profiles, share cards, and astrology context. Zodiacs.org is the official registry and SDK source of truth. The SDK remains neutral infrastructure that any app can use for verified ownership, public reads, identity facts, symbolic resonance, and icon assets.

Read-only by design.

The SDK is made for recognition, verification, metadata, public reads, and identity context. It does not request private keys, provide custody, sign messages, submit transactions, provide approval helpers, or move assets.