Programmatic access to astro-quantitative signals, portfolio data, cycle intelligence, and real-time trade webhooks.
All API requests require an X-API-Key header. Generate your key from the account dashboard after subscribing to an API tier.
# Get current portfolio status curl -H "X-API-Key: sf_live_your_key_here" \ https://sacredfolio.cloud/api/v1/portfolio # Get today's astrological context (Pro tier) curl -H "X-API-Key: sf_live_your_key_here" \ https://sacredfolio.cloud/api/v1/astro/today
Keys follow the format sf_live_<40 hex chars>. Store securely — keys cannot be retrieved after generation.
Three API tiers with sliding-window rate limiting. Headers X-RateLimit-Remaining and X-RateLimit-Limit are included in every response.
| Tier | Rate Limit | Signals | Data | Astro / Cycles | Webhooks | Price |
|---|---|---|---|---|---|---|
| Starter | 30 / min | Active + Latest 20 | 10 Commodities | Summary only | — | $49/mo |
| Pro | 120 / min | Full history + Feed | 239 Commodities + Macro | Full detail | — | $199/mo |
| Enterprise | 600 / min | Everything | Everything + Bulk | Everything | 3Commas, Cornix, TV | Custom |
18 endpoints grouped by function. Click to expand each group.
Currently open positions across all engines.
{
"count": 3,
"positions": [{
"ticker": "BTC",
"direction": "long",
"entry_price": 83241.50,
"stop_loss": 81500.00,
"take_profit": 87000.00,
"unrealized_pnl": 2.14
}]
}
Last 20 closed trades with P&L, entry/exit prices, and signal type.
Aggregated signal feed — crypto, polymarket, sports. Filter by ?category=crypto.
Full trade history with pagination. Query params: page, per_page, symbol, direction.
Portfolio overview — balances, P&L, win rates, active positions per engine.
{
"total_balance": 523847.20,
"total_pnl_pct": 4.77,
"win_rate": 93.8,
"engines": {
"BTC": { "long": { "balance": 52410, "win_rate": 95.5 } }
}
}
Aggregate statistics per symbol and direction — total trades, win rate, avg P&L, best/worst trade.
Current market regime state — bull/bear/neutral with multiplier.
Today's astrological context — numerology, moon phase, zodiac edge, Fibonacci, trine, confluence score.
{
"numerology": { "value": 7, "bias": "bullish", "strength": "strong" },
"moon": {
"phase": "Waxing Gibbous",
"zodiac_sign": "Leo",
"void_of_course": false
},
"confluence": { "score": 78, "bias": "bullish" }
}
Weather-commodity regime intelligence — 18-tier Weatherman pipeline output.
Unusual Whales options flow summary — institutional signals.
Current cycle state. Starter: phase names. Pro+: numerology, confluence, regime, weather. Query: ?date=2026-03-13.
Fibonacci calendar data for a given date.
Trine calendar data for a given date.
Multi-digit calendar — cross-system digit patterns.
List available commodities. Starter: 10 majors. Pro+: all 239.
Price history. Query: ?start_year=2020&end_year=2026.
List available economic series, filterable by category.
Time series data for an economic indicator.
Latest macro indicator values — GDP, CPI, unemployment, rates.
Register a webhook URL to receive trade events in real time.
curl -X POST https://sacredfolio.cloud/api/v1/webhooks/subscribe \ -H "X-API-Key: sf_live_..." \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-server.com/webhook", "format": "3commas", "secret": "your_hmac_secret", "tickers": "BTC,ETH", "events": "open,close" }'
List your active webhook subscriptions with delivery stats.
Remove a webhook subscription.
Send a test payload to verify your webhook is receiving correctly.
Trade events are delivered in your chosen format. All payloads are signed with HMAC-SHA256 via the X-SF-Signature header.
Full Sacred Folio format with astro context, universe metadata, and complete trade data.
format: "json"Bot-ready format — message_type, pair, action. Direct integration with 500K+ trader marketplace.
Text-based signal format for Cornix Telegram bots. Includes pair, direction, entry, targets, stop loss.
format: "cornix"Webhook alert format compatible with TradingView strategy alerts. Ticker, action, price fields.
format: "tradingview"{
"message_type": "bot",
"bot_id": "",
"email_token": "",
"delay_seconds": 0,
"pair": "USDT_BTC",
"action": "open_long",
"order_type": "market"
}
Pine Script v5 indicator for signal overlay and confluence scoring on your charts.
Manual overlay for Sacred Folio trade signals with astrological confluence panel.
Choose an API tier to get your key. Enterprise customers — reach out for custom limits and dedicated support.