Welcome

Sugra API is one HTTP API for finance, macro, entity, internet, news, earth and research data. A single x-api-key gives you access to 1569+ endpoints backed by 163 upstream sources - central banks, statistical offices, regulators, intergovernmental bodies, academic projects and curated commercial feeds served under Sugra-branded wrappers.

Base URL: https://sugra.ai

Authentication: x-api-key header on every /api/ request

Format: JSON, with a consistent data + meta envelope

System endpoints (/health, /about, /services, /sources) require no key

Seven data directions

Direction	Coverage
Sugra Finance	Equities, fundamentals, filings, fixed income, derivatives, crypto, forex
Sugra Macro	Central banks, national statistics, FRED, IMF, World Bank, OECD
Sugra Entity	Company resolution, sanctions and watchlist screening, identifiers
Sugra Net Atlas	Internet infrastructure: ASNs, prefixes, IXPs, routing, DNS
Sugra News	Global news flow and event signals
Sugra Earth	Weather, hazards, energy, transport, air quality, climate
Sugra Research	Scientific, patent and academic datasets

All directions live under the same base URL, key and rate-limit budget. Endpoints are grouped into 36 categories in the API Reference sidebar.

First request

Get a key at https://app.sugra.ai/register (Free plan, no credit card), then:

Response (truncated):

{
  "data": {
    "series_id": "GDP",
    "title": "Gross Domestic Product",
    "units": "Billions of Dollars",
    "frequency": "Quarterly",
    "observations": [
      {"date": "2026-01-01", "value": 31865.721},
      {"date": "2025-10-01", "value": 31422.526},
      {"date": "2025-07-01", "value": 31098.027}
    ]
  },
  "meta": {
    "endpoint": "/api/v1/fred/series/GDP",
    "source": "fred",
    "cached": false
  }
}

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. Daily counters reset at UTC midnight.

Where to go next

Quickstart - key setup, request anatomy, error handling and rate limits in a few minutes.

MCP - connect AI agents to the full catalog through the hosted MCP server at https://app.sugra.ai/mcp or the sugra-api-mcp package.

API Reference - the sidebar on the left documents every endpoint with parameters, schemas and try-it requests.

Plans

Every endpoint is available on every plan. Plans differ only in daily request volume.

Plan	Price	Requests per day
Free	$0	50
Dev	$25/mo	5,000
Pro	$59/mo	50,000
Enterprise	Custom	Custom

Free is a permanent tier, not a trial: no time limit and no credit card required. Commercial use is permitted on all tiers. Upgrade any time from the developer dashboard at https://app.sugra.ai.

Seven data directions#

First request#

Where to go next#

Plans#

Seven data directions

First request

Where to go next

Plans