Documentation
Complete guide to the Almanac Temporal Intelligence Platform
Quick Start
Get up and running with the Almanac Temporal Intelligence Platform in under 5 minutes.
Step 1: Get Your API Key
Contact us at [email protected] to get your API key. We'll have you set up in under 24 hours.
Step 2: Make Your First API Call
curl "https://api.almanac.ai/api/v9/expr/AAPL?date=20250917&location=NYSE"
Step 3: Explore Features
Event Analytics
Revolutionary event-driven market analysis with 13.9M events and 169.5M dates.
Features
| Feature | Description | Status |
|---|---|---|
| Active Candles | Real-time WebSocket updates for live market data | ✅ Production |
| Seasonality Analysis | Fixed seasonality using 169.5M event_dates (no errors) | ✅ Production |
| Intraday Patterns | Hour-by-hour analysis for 1-minute bars | ✅ Production |
| NT8 Yellow Lines | Vertical event markers on charts (NinjaTrader-style) | ✅ Production |
| Forward Projections | Dashed projection lines from last event | ✅ Production |
| Probability Distribution | Lower panel showing outcome probabilities | ✅ Production |
| Return Histogram | Lower panel showing historical returns | ✅ Production |
Example: Nike at Super Bowl
curl "https://api.almanac.ai/finance/api/event/33/analytics?symbol=NKE&timeframe=1min"
Patent Portfolio ($230M-280M+)
13 revolutionary patent applications covering the future of temporal intelligence and automated trading.
Bar-by-bar condition recognition with natural language rules. Your FIRST and MOST VALUABLE patent.
"Golden head among silver needles" - Pre-computed analytics for 1000× faster pattern search.
Natural language temporal expressions: "within 10 mins of sunrise of london"
"Alexa, buy Church & Dwight at solar noon" - Voice-activated temporal intelligence for everyone.
13 Applications covering every aspect of temporal intelligence, event analytics, and automated trading. Total estimated value: $230M-280M+
View All Patents →AU System (347K+ Combinations)
Astronomical Unit quantum temporal system with unlimited combinations and attosecond precision.
No other platform offers 347,000+ AU combinations with cultural intelligence and pre-computed analytics.
Core AU Types
| AU Code | Name | Definition | Precision |
|---|---|---|---|
AUSR |
Solar Rise Process | Sunrise to Solar Noon (~6.5 hours) | Microsecond |
AUSS |
Solar Set Process | Solar Noon to Sunset (~6.5 hours) | Microsecond |
AUDD |
Dual Daylight | Dynamic switching AUSR/AUSS | Sub-microsecond |
AUHLM |
Historical High/Low Baseline | Master baseline for all measurements | Attosecond |
Example: AU Calculation
curl "https://api.almanac.ai/api/v9/expr/AAPL?au_types=AUSR,AUSS&location=NYSE&date=20250917"
Prayer Calculation Methods (17 Total)
Institutional-grade Islamic prayer time calculations with attosecond precision.
| Method | Organization | Fajr | Isha | Accuracy | Region |
|---|---|---|---|---|---|
ISNA |
Islamic Society of North America | 15° | 15° | ±30s | North America |
MWL |
Muslim World League | 18° | 17° | ±20s | Global |
MAKKAH |
Umm al-Qura, Makkah | 18.5° | 90° | ±15s | Saudi Arabia |
EGYPT |
Egyptian General Authority | 19.5° | 17.5° | ±25s | Egypt |
Example: Prayer Times for London
curl "https://api.almanac.ai/api/v9/expr/AAPL?prayers=ISNA&location=London&date=20250917"
Temporal Language DSL (CHRON-012)
Express complex temporal relationships in natural language - human-readable and LLM-friendly.
Natural language syntax means you and your LLM can explore temporal intelligence conversationally. Just describe what you want in plain English!
Natural Language Examples
within 10 mins of sunrise of london 30 mins before dhuhr in mecca 5 days before event 33
during dhuhr in london overlay GBPQAR during event 33 overlay NKE while market open
between sunrise and solar-noon from fajr to dhuhr between event 33 and event 42
API Endpoints
Complete REST API reference for all platform capabilities.
Core Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v9/expr/{expression} |
GET | Universal expression engine (temporal intelligence) |
/finance/api/event/{id}/analytics |
GET | Event analytics for specific event |
/finance/api/symbols/search |
GET | Search 2.7M symbols |
/finance/ws/candles/{symbol} |
WebSocket | Real-time active candles |
/widgets/{widget_name} |
GET | Embeddable widgets (monetizable) |