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 1,600+ endpoints backed by 160+ 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 NetAtlas	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 free key at app.sugra.ai/register, 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 (https://mcp.sugra.ai) or the sugra-api-mcp package. In Claude, Add to Claude connects the Sugra API MCP server from Anthropic's Connectors Directory; in ChatGPT and Codex, Add to ChatGPT installs it from the OpenAI Plugins Directory.

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

Plans and billing - plans, annual billing, and how to change or cancel a plan.

Request cost and error codes - how much of the daily quota a call uses, and the labels an error carries.

Ecosystem - the MCP server, the OpenBB extension, the skills and the cookbook.

Status and support - the status page, the SLA and how to reach support.

Plans

Every endpoint is available on every plan. Plans differ in daily request volume, and the SLA covers the paid plans (see Plans and billing).

Plan	Price	Requests per day
Free	$0	50
Personal	$9/mo	1,000
Dev	$25/mo	5,000
Pro	$59/mo	50,000

Personal: see the Personal quickstart.

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.

Seven data directions#

First request#

Where to go next#

Plans#

Seven data directions

First request

Where to go next

Plans