← Back to home
API Documentation
Access Sovarion forecasts, research reports, and market data programmatically. Available with Sovarion One.
Authentication
Include your API key in the X-API-Key header:
curl -H "X-API-Key: qk_your_key_here" \ https://sovarion-api-production.up.railway.app/v1/forecasts/latest
Generate API keys in your Account Settings. Max 3 active keys. Keys start with qk_.
Rate Limits
| Plan | Daily Limit | Reset |
|---|---|---|
| Sovarion One | 1,000 requests/day | Midnight UTC |
| API Add-On | 500 requests/day | Midnight UTC |
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Endpoints
GET
/v1/forecasts/latestGet the latest forecast for all assets.
Query params:
horizon—30min(default),7d, or30d
GET /v1/forecasts/latest?horizon=30d
→ { forecasts: [...], count: 10, fetched_at: "..." }GET
/v1/forecasts/:assetGet the latest forecast for a specific asset.
Path params:
asset—aapl,spx,tsla, etc.
Query params:
horizon—30min,7d, or30d
GET
/v1/forecasts/archiveGet historical forecasts with pagination.
horizon— Filter by horizonasset— Filter by asset IDlimit— Max results (default 20, max 100)offset— Pagination offset
GET
/v1/forecasts/accuracyGet accuracy statistics.
horizon— Filter by horizon
GET
/v1/forecasts/exampleGet a public example 30-day research report (no auth required).
Available Assets
spxS&P 500
ndxNasdaq 100
daxDAX
djiDow Jones
aaplApple
msftMicrosoft
tslaTesla
amznAmazon
nvdaNvidia
metaMeta
Response Format
All responses are JSON. Forecast objects include:
{
"id": 487,
"asset": "aapl",
"symbol": "AAPL",
"asset_name": "Apple Inc.",
"directional_bias": "BEARISH",
"confidence_score": 34,
"signal_quality": 42,
"decision_class": "controlled_bearish",
"market_regime": "range",
"summary": "We initiate with UNDERWEIGHT...",
"horizon": "30d",
"generated_at": "2026-04-05T19:07:26.461Z",
"valid_until": "2026-05-04T19:07:26.461Z",
"brain_metadata": { ... } // Full scoring data
}Ready to integrate?
Get Sovarion One for API access →