Sugra API v2

Every market signal.
One unified channel.

Sugra API v2 is a RESTful financial data API aggregating stock market data, macroeconomic indicators, FRED time series, and technical analysis from multiple sources - designed for AI agents, LLMs, and custom financial applications.

Finance Markets

30+

Endpoints per symbol - real-time prices, OHLCV history, options chains, financial statements, earnings, ownership, analyst intelligence, technical analysis, SEC filings, and more.

Economic Indicators

190+

Countries covered across 10 macroeconomic sections per country - GDP, labour, prices, health, money, trade, government, business, consumer, and housing.

FRED Time Series

27

Series across US (18), Eurozone, UK, and Japan (3 each) - with semantic transforms, flexible date ranges, and concurrent batch fetching.

What the API covers

Full capability breakdown.

Finance - Prices & History

  • Real-time price - bid, ask, volume, market cap, 52-week range
  • Historical OHLCV - 1d to max, or custom start/end date range
  • Dividends - yield, rate, ex-date, last payment date
  • Corporate actions - splits and dividends, filterable by days
  • ISIN code - ISO 6166 identifier
  • Multi-symbol batch - up to 10 symbols, info or history type

Finance - Earnings & Estimates

  • Earnings history - EPS actual vs estimate, difference, surprise %
  • Forward estimates - earnings and revenue by period (0q/+1q/0y/+1y)
  • Earnings calendar - upcoming earnings and dividend dates
  • Earnings dates - full historical announcement schedule
  • Financial statements - income statement, balance sheet, cash flow (annual and quarterly)

Finance - Analyst & Ownership

  • Analyst targets - consensus, low, high, mean price target and count
  • Upgrades/downgrades - grade changes over last 6 months
  • Recommendations - buy/hold/sell aggregate over time
  • Major holders - insider, institutional, and mutual fund % breakdown
  • Institutional holders - top institution positions and share counts
  • Mutual fund holders - top fund positions
  • Insider roster - named insiders and roles
  • Insider transactions - buy/sell activity with dates and values

Finance - Options & Technicals

  • Options expirations - all available expiration dates for a symbol
  • Options chain - full calls and puts for any expiration date, with IV, Greeks, volume, open interest
  • Technical analysis - TradingView TA: buy/sell/neutral signal, oscillators, moving averages, across 9 intervals (1m to 1M)
  • Fund profile - ETF overview, asset classes, top holdings, sector weightings
  • SEC filings - EDGAR documents with direct download links, filterable by days
  • Price targets - last 3 months via Finviz

Economics - Country Data

  • Countries overview - global heatmap matrix for ~190 countries
  • Full country indicators - all sections in one call per country
  • GDP section - growth, size, debt, deficit, current account
  • Labour section - unemployment, wages, employment rate, productivity
  • Prices section - CPI, inflation rate, food and housing prices
  • Money, trade, government, health, business, consumer, housing - dedicated section endpoints per country
  • Each row: Last, Previous, Change, ChangePercent, Highest, Lowest, Unit, Reference
  • Keyword filtering via ?Related= query param

FRED Macro - Time Series

  • US (18 series) - CPI, Core CPI, PCE, Core PCE, PPI, GDP, Real GDP, Unemployment, Payrolls, Retail Sales, Industrial Production, Housing Starts, M2, Fed Funds Rate, Fed Funds Target, T10Y, T2Y, T10Y-T2Y Spread
  • Eurozone, UK, Japan - CPI, Unemployment, GDP for each region
  • Semantic transforms - mom_pct, yoy_pct, qoq_ann_pct, dod_bps, wow_bps, mom_pp, yoy_pp, mom_abs, yoy_abs - validated per series unit_type
  • Modes - last-N observations or date range
  • Batch endpoint - up to 5 series in one call, errors isolated
  • Meta - last_updated from FRED, effective range, transform lookback, cache status

Documentation

Start building.