API / Platform

Platform architecture and
full capability breakdown.

How 863 endpoints across 104 primary sources fit into one unified integration. Aggregation, failover, normalization, LLM-ready envelope - and the full list of what the API covers, domain by domain.

Start free API docs → View pricing
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 primary sources - equities, corporate filings, economics, crypto, forex, commodities, agriculture, climate, predictions, digital economy, environment, and global news. 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.

LLM-ready by design

Consistent envelope (data + meta), source timestamps, and semantic unit types in every response. Drop directly into an agent or model with zero transformation. Plus a native Model Context Protocol server - connect Anthropic Claude, OpenAI GPT, Google Gemini, xAI, or any MCP client in one line.

What the API covers

Full capability breakdown.

863 endpoints, 15 data domains, 104 primary sources. Here is what sits behind a single integration.

Finance - Prices & History
  • Latest 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, 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, 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, with IV, Greeks, volume, open interest
  • Technical analysis - buy/sell/neutral signal, oscillators, moving averages, 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
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
  • Per-row fields - 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, 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 (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
  • Forex convert - currency conversion endpoint
  • Forex history - historical exchange rates, last 90 days
  • CBR rates - RUB-based reference rates
Central Banks & Financial Stability
  • Policy rates - 49 central banks worldwide
  • Credit-to-GDP gaps - financial stability indicator
  • Debt service ratios - 32 countries
  • Property prices - residential and commercial, 61 countries
  • Effective exchange rates - REER/NEER, 64 countries
  • Central bank balance sheets - total assets
  • Global liquidity - cross-border credit indicators
Corporate Filings - Japan
  • Annual reports - XBRL financials (income, balance, cash flow)
  • Quarterly reports - YTD cumulative financials
  • Large shareholding - 5%+ ownership disclosures
  • Tender offers - M&A filings
  • Internal control - J-SOX evaluation
  • Treasury stock - share buyback reports
  • 42 document types - J-GAAP and IFRS support
US Government
  • National debt - daily, history since 1790
  • Federal spending - 111 agencies, by state
  • Treasury auctions - since 1979, CUSIP, yields
  • Gold reserve - by storage location
  • Budget deficit - monthly receipts and outlays
  • Interest rates - average rates on Treasury securities
Agriculture & Food
  • Crop production - 245+ countries, since 1961
  • Agricultural trade - imports/exports by commodity
  • Producer prices - agricultural commodity prices
  • Food balance - supply, utilization, per capita
  • Emissions - agrifood greenhouse gases
  • Food security - undernourishment, stunting
  • Land use - agricultural, forest, arable area
Global News & Media
  • Article search - 100+ languages, 250K+ sources
  • Sentiment analysis - tone distribution by topic
  • Coverage timeline - volume and trend over time
  • Sentence extraction - actual text with context
  • TV news search - 2M+ hours since 2009
National Statistics & Reference
  • Canada - 8,161 tables, CPI since 1914
  • Australia - 1,223 datasets, CPI since 1948
  • Bank of Japan - 326K series, TANKAN
  • Bank of England - Bank Rate, SONIA, gilt yields
  • Instrument mapping - ticker, ISIN, CUSIP, SEDOL to FIGI
  • 28 identifier types - all global exchanges
Predictions & Event Markets
  • Political markets - elections, legislation, policy odds
  • Macro markets - rates, inflation, GDP outcomes
  • CFTC-regulated exchange - Kalshi contracts and prices
  • Decentralized markets - on-chain prediction liquidity
  • Order book depth - yes/no prices, volume, open interest
Digital Economy & Infrastructure
  • DeFi TVL - protocols, stablecoins, DEX, yields, options
  • Bitcoin network - mempool, fees, hashrate, UTXO state
  • On-chain metrics - active addresses, network health
  • Internet routing - BGP, ASN lookups, global outage detection
  • Certificate transparency - domain issuance, CT logs
  • Network probes - global measurement infrastructure
  • Anonymization networks - Tor usage, relay metrics
Environment & Disasters
  • Earthquakes - USGS global feed, magnitude, depth
  • Active fires - NASA FIRMS satellite detection
  • Volcanoes - USGS catalog and eruption events
  • Global disasters - GDACS alerts across hazard types
  • Space weather - NOAA SWPC solar and geomagnetic
  • Power plants - 34,936 plants across 167 countries
  • Vessel activity - fishing, EEZ reports, marine traffic
Finance Economics Macro Fundamentals Commodities Crypto Forex Predictions Digital Economy Environment Weather & Marine Climate Global News & Media World Bank OECD IMF BIS Federal Reserve Bank of Japan Bank of England ECB US Treasury USAspending Congress.gov SEC EDGAR EDINET FRED FAOSTAT Statistics Canada ABS Australia GDELT OpenFIGI Finnhub CBOE CFTC COT FINRA Kalshi Polymarket DefiLlama Coin Metrics Blockchain.com Mempool.space RIPEstat RIPE Atlas IODA Tor Metrics SSLMate CT USGS NASA FIRMS NOAA GDACS WRI Power Plants Global Fishing Watch Wikidata

Full documentation with request parameters and example responses at docs.sugra.ai.

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.

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.