CosmicSelf gives AI platforms a cosmic identity layer — six ancient systems synthesized into a machine-readable profile. Your agent knows who it's talking to before the first word.
CosmicSelf API gives your AI agent a cosmic identity layer. One POST request claims a free Founder key. One GET request returns structured personality traits — decision style, communication preferences, shadow patterns — for any user. No onboarding forms. No credit card. Your agent is personalized from session one.
/api/v1/agent-claimcurl -X POST "https://cosmicself.ai/api/v1/agent-claim" \
-H "Content-Type: application/json" \
-d '{
"agent_name": "Homer",
"creator_email": "you@company.com",
"platform_url": "https://your-app.com",
"use_case": "Personalizing conversations"
}'One API call returns structured personality traits, decision patterns, and communication styles for any user. Six independent systems. Machine-readable output. Built for agents.
Get structured traits in milliseconds. Decision style, communication preferences, motivation sources, shadow patterns. All machine-readable.
Cross-system analysis across Western astrology, Vedic, Human Design, 64 Archetypes, Cardology, and Numerology. No other API has this.
Every response includes next_steps[]. Self-describing /capabilities endpoint. Error shapes with recovery instructions. Built for autonomous agents.
Send birth data via POST /profile/generate. We calculate all 6 systems and synthesize traits in ~8 seconds. Cached permanently after first generation.
GET /profile/{id}/traits returns structured data: decision_style, communication_style, cognitive_style, shadow_pattern, and more. Sub-100ms response.
Use traits to tune your AI agent's responses. Calibrate tone, pacing, decision support, and proactive shadow awareness. Your users feel known.
The first 100 AI platforms to claim a Founder key earn permanent free access and the Founding Platform badge. Every Founding Platform helps shape the API.
100
Founder slots total
Free
Forever. No credit card.
100
Credits/month included
Pay per profile generated. Read requests are unlimited. Profiles are cached permanently after first generation.
100 profiles · 5 req/s
100 profiles · 10 req/s
500 profiles · 100 req/s
2,000 profiles · 500 req/s
Your agent knows the user's decision style before the first interaction. Emotional authority users get options with time to reflect. Sacral responders get clear yes/no choices.
Adapt onboarding flows based on cognitive style and motivation source. Analytical users get detailed setup. Intuitive users get streamlined paths.
Tailor content recommendations, coaching prompts, and self-development tracks based on the user's archetype profile.
Proactively flag when a user might be operating from their shadow pattern. "It sounds like you're in seriousness mode right now" becomes possible.
CosmicSelf API gives AI platforms a cosmic identity layer — six ancient systems (Western astrology, Vedic astrology, Human Design, 64 Archetypes, Cardology, and Numerology) synthesized into a machine-readable profile. One API call returns decision style, communication style, shadow pattern, and other traits your AI can use to personalize every interaction.
AI agent platforms can claim a free Founder key with POST /api/v1/agent-claim. Include your agent name, creator email, and platform URL. First 100 platforms get the Founding Platform badge and 100 free profile credits per month, forever.
CosmicSelf synthesizes six systems: Western astrology (natal chart, planetary positions), Vedic astrology (sidereal chart, nakshatra), Human Design (type, authority, profile, defined centers), 64 Archetypes (key gates and channels), Cardology (birth card, planetary ruling card), and Numerology (life path, expression, soul urge).
Yes. Founder keys include 100 profile credits per month with no expiration and no credit card required. The only limit is a hard cap at 100 credits — no overage charges. If you need more, upgrade to a paid tier. First 100 platforms also get the Founding Platform badge.
CosmicSelf uses Cloudflare at the edge (bot fight mode, DDoS protection, IP rate limiting) combined with Upstash Redis sliding-window rate limiting per API key at the application layer. Unauthenticated endpoints are limited to 100 requests per minute per IP. Authenticated keys have tier-based limits.
All responses are JSON. Every response includes a data object, a next_steps[] array with plain-English suggestions, and a capabilities object. Trait fields include decision_style, communication_style, motivation_source, depletion_triggers, shadow_pattern, strength_signals, cognitive_style, and rarity_score.
For Starter, Growth, Scale, or Enterprise access, apply below. We review applications within 48 hours.
Read the docs firstorContact Us