đ StockScreener Intelligence API
Comprehensive API for stock analysis, shipping intelligence, and ML signal analysis
v1.5.2
đ Swagger UI
đ ReDoc
âšī¸ API Info
â¤ī¸ Health
đ¯ TD25 Dashboard
â Back to App
50+
API Endpoints
10
ML Models
500+
Weekly Reports
3
Horizons
đ¯
TD25 Tanker Signal Analysis
10
âŧ
GET
Dashboard Data (Cached)
/api/v1/signal/dashboard/cached
All models, signals, and backtest in one call. Parameters: horizon (15/30/45)
Auth
Cached
ML
POST
Train All Models
/api/v1/signal/train/all
Train XGBoost, LightGBM, CatBoost, Random Forest, LSTM, MLP, Prophet
Auth
ML
GET
Run Backtest
/api/v1/signal/backtest
Historical performance of all models with chart data
Auth
GET
Get TD25 Data
/api/v1/signal/td25
TD25 spot rates, FFA rates, vessel supply data
Auth
đ
Hybrid Weekly Signal Generator (NLP + Data)
5
âŧ
GET
Get Signal
/api/v1/hybrid/predict?horizon=15
Signal interpretation using FinBERT sentiment + numerical features. Horizons: 15, 30, 45 days
Auth
ML
POST
Train Hybrid Model
/api/v1/hybrid/train?all_horizons=true
Train for single horizon or all horizons. Uses Baltic report sentiment
Auth
ML
GET
Model Status
/api/v1/hybrid/status
Check trained horizons, metrics, feature count
Auth
GET
Feature Importance
/api/v1/hybrid/features
Top features used by the hybrid model
Auth
GET
Run Backtest
/api/v1/hybrid/backtest
Historical backtest for hybrid model
Auth
đ
Baltic Exchange Reports
6
âŧ
GET
Collection Status
/api/v1/baltic/status
Statistics about collected reports, date range, counts
Auth
GET
Get All Narratives
/api/v1/baltic/narratives
All report narratives for chart hover display
Auth
GET
TD25 History
/api/v1/baltic/td25
TD25 weekly data: WS rates, TCE, direction, narratives
Auth
POST
Backfill Year
/api/v1/baltic/backfill/{year}
Scrape all weekly reports for a year (2015-2025)
Auth
POST
Backfill All Years
/api/v1/baltic/backfill-all
Backfill 2015-2025 (background task)
Auth
GET
Discover Report URLs
/api/v1/baltic/discover/{year}
Find report URLs for a specific year
Auth
đ
Stock Market Analysis
15
âŧ
GET
Stock Screener
/api/v1/screener/stocks
Screen 5,500+ stocks with 50+ filters
Auth
Cached
GET
Single Stock
/api/v1/screener/ticker/{symbol}
Comprehensive data for one stock
Auth
GET
Stock Quote (Real-time)
/api/v1/stock/{symbol}/quote
Real-time price with pre/after-hours
Auth
GET
Stock Statistics
/api/v1/stock/{symbol}/statistics
24+ metrics: valuation, profitability, health
Auth
GET
Earnings Calendar
/api/v1/earnings/calendar
Upcoming earnings reports with estimates
Auth
Cached
GET
Sectors
/api/v1/sectors
11 sectors with aggregated statistics
Auth
Cached
GET
Industries
/api/v1/industries
145 industries with detailed stats
Auth
Cached
GET
Market Movers
/api/v1/movers/premarket
Pre-market gainers and losers
Auth
GET
ETF Screener
/api/v1/etfs/
501+ ETFs with AUM, expense ratios
Auth
Cached
GET
IPO Calendar
/api/v1/ipos/calendar
Upcoming IPOs with price ranges
Auth
đĸ
Shipping Intelligence
8
âŧ
GET
Shipping Overview
/api/v1/shipping/overview
Market overview with key metrics
Auth
GET
Tanker Rates
/api/v1/shipping/rates
Current tanker spot rates by route
Auth
GET
Port Data
/api/v1/shipping/ports
Port congestion and vessel counts
Auth
GET
Trade Routes
/api/v1/shipping/routes
Major tanker trade routes
Auth
đ
Historical Data (TimescaleDB)
6
âŧ
GET
Stock History
/api/v1/history/stocks/{symbol}
Historical OHLCV data from 2022
Auth
GET
Freight Rates History
/api/v1/history/freight/{index_name}
Historical tanker/freight rates
Auth
GET
Database Statistics
/api/v1/history/statistics
TimescaleDB health and stats
Auth
đ
Authentication
4
âŧ
GET
Login (Redirect to Keycloak)
/api/v1/auth/login
Initiates OAuth2 login flow
GET
OAuth Callback
/api/v1/auth/callback
Handles Keycloak redirect
GET
Logout
/api/v1/auth/logout
Clear session and redirect
GET
Auth Config
/api/v1/auth/config
Keycloak configuration