API Reference

Technical documentation for integrating with Fatum's API

Coming Soon

API documentation will be available with the beta release

API Overview

The Fatum API will provide developers with programmatic access to our AI astrology assistants, enabling integration of astrological insights into third-party applications and services.

Authentication

Secure API key-based authentication with OAuth 2.0 support for enhanced security.

RESTful API

Clean, intuitive RESTful endpoints with JSON responses for easy integration.

Rate Limiting

Fair usage policies with tiered rate limits based on your subscription plan.

SDKs

Official SDKs for JavaScript, Python, Ruby, and Go to simplify integration.

Planned Endpoints

GET/api/v1/horoscope

Retrieve daily, weekly, or monthly horoscope for a specific zodiac sign

POST/api/v1/chat

Send a message to the AI assistant and receive a response

GET/api/v1/birth-chart

Generate a detailed birth chart analysis based on birth data

GET/api/v1/compatibility

Calculate compatibility between two zodiac signs

GET/api/v1/transits

Get current planetary transits and their influences

Web3 API Endpoints

Blockchain-integrated endpoints for Web3 functionality, including NFT minting, token operations, and on-chain data management.

POST/api/v1/web3/nft/mint

Mint a birth chart as an NFT on the blockchain

GET/api/v1/web3/wallet

Retrieve user's Web3 wallet information and token balance

POST/api/v1/web3/governance/vote

Submit a vote for DAO governance proposals

GET/api/v1/web3/nft/collection

View user's NFT collection of astrological charts

Example Request

Here's a preview of what API requests will look like:

curl -X GET "https://api.fatumapp.com/v1/horoscope" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "zodiac_sign": "leo",
    "period": "daily"
  }'

Developer Access

API access will be available to registered developers after the beta launch. Both traditional RESTful APIs and Web3-integrated endpoints will be accessible. Sign up for our waiting list to be notified when API keys become available.