Sugra API - Data infrastructure for decisions that matter

Every data point that matters.
One unified channel.

Sugra API aggregates financial markets, macroeconomic data, commodities, weather, climate, and more - normalized to a single output format, delivered through one endpoint. Built for AI agents, LLMs, and custom applications that need the full picture.

API Documentation
91+
API Endpoints

Finance, macro, crypto, forex, weather, climate, commodities, marine, air quality, and more - unified under one channel.

14+
Data Domains

From equity markets and SEC filings to CMIP6 climate projections to 2050. Every domain that affects a real-world decision.

190+
Countries Covered

Economics, World Bank, IMF, and OECD data across 190+ countries. GDP, inflation, unemployment, trade, and more.

Architecture

One call. Every domain. Always the same output.

Sugra API sits between your application and every data source you would otherwise have to integrate, maintain, and monitor individually. You make one call. We handle the rest. Source routing, failover, normalization, and caching happen inside the layer. What you receive is always the same structured JSON - regardless of which source delivered it.

Multi-source aggregation

Data from a growing network of providers - equities, crypto, forex, macro indicators, commodities, weather, climate, and more. One integration. Every source.

Automatic failover

If a data source goes down, the next available source takes over transparently. No changes required on your side. No downtime from upstream failures.

Unified output format

Every endpoint returns structured JSON regardless of the underlying source. Build once. Add new data domains without touching your integration.

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
Weather & Marine
  • Current conditions - temperature, wind, precipitation, humidity for any location
  • Daily forecast - up to 16 days ahead, global coverage
  • Historical weather - daily data from 1940 to present
  • Geocoding - city name to coordinates lookup
  • US alerts - active weather alerts via NOAA NWS
  • US forecast - 7-day and hourly via NWS (US only)
  • Marine conditions - wave height, ocean currents, sea surface temperature
  • Marine forecast - daily and hourly, up to 7 days
Climate & Air Quality
  • Historical climate - 70 years of climate trend data, global coverage
  • Climate projections - CMIP6 model projections to 2050
  • Available models - list of supported CMIP6 climate models
  • Air quality current - PM2.5, PM10, NO2, ozone, European and US AQI indices
  • Air quality forecast - hourly air quality forecast, global coverage
Commodities & Forex
  • Commodity catalog - full list of available commodities
  • Latest prices - current prices across 18 commodities
  • Energy - crude oil (Brent & WTI), natural gas prices, US crude oil inventory
  • Agriculture - wheat, corn, soybeans, rice, coffee, sugar, cotton, rubber
  • Metals - gold, silver, platinum, copper, aluminum, iron ore
  • Commodity history - historical prices per commodity ID
  • Forex latest - EUR-based reference rates for ~30 currencies via ECB
  • Forex convert - currency conversion endpoint
  • Forex history - historical exchange rates, last 90 days
  • CBR rates - RUB-based rates from Central Bank of Russia
Crypto World Bank Fundamentals OECD IMF

Full documentation with request parameters and example responses at /docs

Documentation

Start building.

API Documentation
Interactive Swagger UI for all endpoints - Finance, Economics, Macro, Crypto, Forex, Weather, Commodities, and more.
sugra.ai/docs
Services Status
Coming soon
Live health status for all endpoints, refreshed every 5 minutes.
sugra.ai/services-status
Demo - Stock Data (AAPL)
Live detailed stock info for Apple - price, volume, market cap, financials, and more.
sugra.ai/api/quotes/AAPL/
Demo - Economics Overview
Macroeconomic indicators across ~190 countries - GDP, inflation, unemployment.
sugra.ai/api/economics/countries-overview
Demo - FRED Macro Catalog
Full catalog of FRED time series - CPI, GDP, Fed Funds, Treasury yields, and more.
sugra.ai/api/macro/catalog
Demo - Crypto Markets
Top cryptocurrencies by market cap - prices, volume, 24h change, and global stats.
sugra.ai/api/crypto/markets
About

Built by Sugra Systems, Inc.

Sugra API is the data layer of the Sugra platform - powering Sugra AI, Sugra Assist, and Sugra App. The same infrastructure is available to external developers and businesses that need reliable, multi-domain data in a single unified channel.

We started working with AI in financial applications in 2020, through Microsoft for Startups, before the current AI cycle began. We were early. We were right.

Learn more about Sugra Systems -> For business inquiries ->
Get in touch

Interested in API access?

Whether you are integrating market data into your product, building on AI agents, or exploring a custom data solution for fintech or telecom - write to us. We respond within one business day.

Write to us [email protected]