Developer Tools

Sugra API

by Sugra Systems, Inc.

Overview

Sugra API is intelligence infrastructure for AI agents and decision platforms: one key and one normalized format for cross-domain primary-source data, surfaced to agents through the Model Context Protocol. The connector exposes a small, stable tool surface over the full Sugra catalog of more than 1,300 endpoints aggregating 130+ primary sources across data domains including markets, macroeconomics and central banks, corporate filings, public finance, trade flows, agriculture, climate and natural events, maritime activity, prediction markets, global news, network intelligence, and entity screening. Main workflows: discover endpoints by natural-language search and inspect their schemas, run a one-step find-and-call to retrieve data, pull macroeconomic series and central-bank rates, fetch market prices, history and fundamentals through Sugra Finance, screen a person or organization name against sanctions corpora, resolve free text to a canonical entity, and compose a normalized current view or bounded timeseries for an entity with freshness and provenance. Works with Anthropic, OpenAI, Google, and xAI model families and any MCP-enabled client. A free Sugra account is the only connection requirement; the read-only surface never writes, deletes, sends, or publishes.

Tools

compare_country_indicator

ChatGPT

One World Bank development indicator for several countries side by side.

convert_currency

ChatGPT

Convert an amount from one currency to another at the latest reference rate.

get_airport

ChatGPT

Details of one airport by its four-letter or three-letter airport code.

get_airport_weather_reports

ChatGPT

Current aviation weather observations at airports, by airport code.

get_analyst_estimates

ChatGPT

Analyst consensus forecasts of revenue and earnings per share for the coming quarters and years for one company.

get_analyst_price_targets

ChatGPT

Analyst price targets for one stock: low, mean, median and high target and the number of analysts.

get_autonomous_system

ChatGPT

Overview of one internet autonomous system by its number: operator, registry record and announced address space.

get_average_directional_index

ChatGPT

Average directional index of one symbol, which measures trend strength.

get_balance_sheet

ChatGPT

Balance sheet of a US-listed company from its SEC filings: assets, liabilities and equity, annual or quarterly.

get_bollinger_bands

ChatGPT

Bollinger Bands of one symbol: a moving average with upper and lower bands two standard deviations away.

get_cash_flow_statement

ChatGPT

Cash flow statement of a US-listed company from its SEC filings: operating, investing and financing cash flows, annual or quarterly.

get_central_bank_meetings

ChatGPT

Meeting calendar of major central banks: the Federal Reserve, European Central Bank, Bank of England, Bank of Japan and others.

get_central_bank_policy_rates

ChatGPT

Policy interest rates of central banks around the world from the Bank for International Settlements.

get_chain_total_value_locked

ChatGPT

History of the total value locked in decentralised finance on one blockchain.

get_commodity_futures_positioning

ChatGPT

Weekly positions of producers, swap dealers, managed money and others in commodity futures, from the US Commodity Futures Trading Commission.

get_commodity_price_history

ChatGPT

Price history of one commodity by its identifier.

get_commodity_prices

ChatGPT

Latest prices of major commodities: energy, metals and agriculture.

get_commodity_trade

ChatGPT

International trade values by reporter country, partner, flow and commodity code from United Nations trade statistics.

get_company_earnings_date

ChatGPT

The next earnings date and dividend dates of one company.

get_company_filings

ChatGPT

List of SEC filings of one US-listed company (annual and quarterly reports, current reports and others) with dates and links.

get_congress_bill

ChatGPT

Details of one US Congress bill: sponsor, status, actions and summary.

get_consumer_prices_by_country

ChatGPT

Consumer price indices by country from the Bank for International Settlements.

get_country_indicator

ChatGPT

History of one World Bank development indicator (for example GDP, population, inflation) for one country.

get_country_macro_profile

ChatGPT

A country's main macroeconomic indicators in one view: growth, inflation, unemployment, interest rates and more.

get_country_macro_series

ChatGPT

A country's macroeconomic time series for one section, such as prices, labour, output or rates.

get_credit_to_private_sector

ChatGPT

Total credit to households, companies and government by country from the Bank for International Settlements.

get_crude_oil_prices

ChatGPT

Brent and WTI crude oil spot prices from the US Energy Information Administration.

get_crypto_market_overview

ChatGPT

Totals for the whole cryptocurrency market: market capitalisation, volume and the share of the largest coins.

get_crypto_markets

ChatGPT

Cryptocurrencies ranked by market capitalisation with price and change, or a chosen list of coins.

get_crypto_price

ChatGPT

Current price, market capitalisation, volume and 24-hour change of one cryptocurrency.

get_crypto_price_history

ChatGPT

Price, market capitalisation and volume history of one cryptocurrency over a chosen number of days.

get_crypto_sentiment_index

ChatGPT

History of a daily crypto market sentiment index that runs from extreme fear (0) to extreme greed (100).

get_debt_maturity_schedule

ChatGPT

When the debt of a US-listed company comes due, by year, from its SEC filings.

get_defi_protocol_fees

ChatGPT

Fees and revenue earned by decentralised finance protocols.

get_disaster_events

ChatGPT

Recent natural disaster events worldwide (earthquakes, floods, cyclones, droughts and others) with alert levels.

get_dividends_and_splits

ChatGPT

Dividend payments and stock splits of one symbol over a chosen number of days.

get_domain_dns_records

ChatGPT

Current DNS records of an internet domain.

get_domain_registration

ChatGPT

Registration record of an internet domain: registrar, creation and expiry dates, status and name servers.

get_earnings_calendar

ChatGPT

Market-wide calendar of upcoming company earnings reports between two dates, optionally filtered by company name or symbol.

get_earnings_history

ChatGPT

Past quarterly earnings of one company: reported versus expected earnings per share and the surprise.

get_economic_release_calendar

ChatGPT

Calendar of scheduled economic data releases, upcoming or between two dates.

get_economic_series

ChatGPT

Observations of one economic time series from FRED by its series identifier (for example CPIAUCSL for US consumer prices, UNRATE for unemployment, GDP), with optional dates, frequency and units.

get_etf_holdings

ChatGPT

Holdings of one US ETF from its latest quarterly SEC portfolio filing.

get_eu_production_sales

ChatGPT

Value and volume of goods sold by producers in an EU country for one product code, from Eurostat.

get_eurostat_dataset

ChatGPT

Values from one Eurostat dataset by its code, optionally for one country and period.

get_event_contract

ChatGPT

One Kalshi event by its event ticker, with every market in it and the current implied probabilities. Read-only market data.

get_event_contract_orderbook

ChatGPT

Current order book of one Kalshi market: resting bids at each price. Read-only market data.

get_event_contract_price_history

ChatGPT

Price history of one Kalshi market, which reads as the market-implied probability over time. Read-only market data.

get_exchange_rate_history

ChatGPT

Official reference exchange rates against the euro over the last 90 days.

get_exchange_rates

ChatGPT

Latest official reference exchange rates against the euro.

get_exponential_moving_average

ChatGPT

Exponential moving average of one symbol's price over a chosen number of periods.

get_financial_futures_positioning

ChatGPT

Weekly positions of dealers, asset managers, leveraged funds and others in financial futures, from the US Commodity Futures Trading Commission.

get_financial_ratios

ChatGPT

Financial ratios of a US-listed company computed from its SEC filings: margins, returns, leverage and liquidity.

get_fund_flows

ChatGPT

Weekly net flows into US ETFs and mutual funds by broad category.

get_fund_summary

ChatGPT

Summary of one ETF or mutual fund: category, fund family, expense ratio, total assets and top holdings.

get_futures_contracts

ChatGPT

The chain of listed futures contracts for one root symbol with their expiration dates.

get_futures_curve

ChatGPT

The futures term structure for one root symbol: the price of each listed expiration, to see contango or backwardation.

get_futures_positioning_history

ChatGPT

History of trader positioning in one futures market from the US Commodity Futures Trading Commission reports.

get_futures_price_history

ChatGPT

Price history of a futures contract by root symbol (for example crude oil, gold, equity index futures), front month or a chosen expiration.

get_german_statistics_table

ChatGPT

A table from Germany's Federal Statistical Office by its table code, for chosen years.

get_gold_price_fixing

ChatGPT

The latest official gold price fixing published by the National Bank of Poland.

get_grain_prices

ChatGPT

US grain and crop prices from the US Department of Agriculture.

get_hazard_alerts

ChatGPT

Current multi-hazard alerts worldwide by event type and alert level.

get_health_indicator

ChatGPT

Values of one World Health Organization health indicator by country, year, sex and age group.

get_hormuz_strait_transits

ChatGPT

Weekly count of ship transits through the Strait of Hormuz.

get_ichimoku_cloud

ChatGPT

Ichimoku cloud lines of one symbol: conversion, base, leading spans and lagging span.

get_ilo_labour_data

ChatGPT

Labour statistics from one International Labour Organization dataset (employment, wages, working time and more) by country, sex and age.

get_imf_time_series

ChatGPT

A time series from an International Monetary Fund dataset for one country, by dataset and indicator.

get_implied_volatility_rank

ChatGPT

Where the current at-the-money implied volatility of one symbol sits within its own history, as a rank and a percentile.

get_income_statement

ChatGPT

Income statement of a US-listed company from its SEC filings: revenue, costs, operating income, net income and earnings per share, annual or quarterly.

get_ip_address_info

ChatGPT

What is known about one IP address: the network that announces it, its registry record and country of registration.

get_japan_annual_financials

ChatGPT

Financial statements from the latest annual securities report of one Japanese listed company from EDINET.

get_japan_company_filings

ChatGPT

Regulatory filings of one Japanese listed company from EDINET, Japan's official disclosure system, over a chosen number of days.

get_japan_filing_document

ChatGPT

The parsed contents of one EDINET filing of a Japanese company, by its document identifier.

get_japan_quarterly_report

ChatGPT

The latest quarterly or semi-annual report of one Japanese listed company from EDINET, parsed.

get_legal_entity

ChatGPT

The full Legal Entity Identifier record of one entity: legal name, addresses, registration and status.

get_legal_entity_relationships

ChatGPT

Parent and subsidiary relationships of one legal entity by its Legal Entity Identifier.

get_market_movers

ChatGPT

A predefined stock list such as top gainers, top losers or most active, with prices and changes.

get_moving_average

ChatGPT

Simple moving average of one symbol's price over a chosen number of periods.

get_moving_average_convergence_divergence

ChatGPT

Moving average convergence divergence of one symbol: the MACD line, signal line and histogram.

get_natural_gas_prices

ChatGPT

US natural gas prices from the US Energy Information Administration.

get_options_skew

ChatGPT

Options volatility skew for one symbol and expiry: 25-delta put and call implied volatility and at-the-money implied volatility.

get_percentage_return

ChatGPT

Percentage return of one symbol over a chosen number of periods, as a series.

get_pivot_points

ChatGPT

Floor-trader pivot points of one symbol: pivot, support and resistance levels.

get_port_congestion

ChatGPT

Ports whose ship calls deviate most from normal, by country, from International Monetary Fund port data.

get_power_generation_mix

ChatGPT

Electricity generation by fuel type (gas, coal, nuclear, wind, solar and others) for a power grid region.

get_power_grid_data

ChatGPT

Electricity demand, generation and related operating data for a power grid region in the US, UK or Europe.

get_prediction_market_event

ChatGPT

One Polymarket event by its identifier with all of its markets and current prices. Read-only market data.

get_price_history

ChatGPT

Open, high, low, close and volume history for one stock, ETF, index or currency pair symbol, daily or intraday. Use for charts, returns over a period, or the price on a past date.

get_put_call_ratio

ChatGPT

History of the market-wide options put/call ratio by family (total, index, equity and others). Use as a gauge of options market sentiment.

get_recent_earthquakes

ChatGPT

Recent earthquakes worldwide above a chosen magnitude.

get_relative_strength_index

ChatGPT

Relative strength index of one symbol, a momentum gauge from 0 to 100 that flags overbought and oversold levels.

get_reported_financial_items

ChatGPT

Specific line items a US-listed company reported in its SEC filings, by their reporting concept names, for chosen periods.

get_retail_electricity_prices

ChatGPT

Average retail electricity prices by US state and customer sector.

get_river_gauge_readings

ChatGPT

Live streamflow and water level readings of one US Geological Survey monitoring site by its site number.

get_scholarly_work

ChatGPT

Full metadata of one scholarly work by its DOI.

get_sector_relative_strength

ChatGPT

US stock market sectors ranked by relative strength over a chosen window.

get_settlement_fails

ChatGPT

Failures to deliver and failures to receive reported by US primary dealers, by asset class, from the Federal Reserve Bank of New York.

get_short_interest

ChatGPT

Short interest positions in US stocks for a settlement date, reported twice a month.

get_snapshot

ChatGPT

Composed current view of an entity via a named recipe. Executes a fixed server-side recipe (company_snapshot, etf_snapshot, quote_snapshot, macro_indicator_snapshot, macro_calendar, earnings_snapshot, debt_snapshot) and returns one envelope with freshness, provenance, per-component coverage, and billing. Composed calls charge the recipe's fixed cost (1-2 units) from the daily quota. status "partial" means an optional component was unavailable - the present components are still trustworthy; honor the freshness block (stale=true means the data aged past its budget); for macro_calendar, entity is accepted but does not filter the calendar. Args: recipe: Recipe name from the fixed manifest. entity: Entity dict from resolve_entity ({"namespace": ..., "ids": ...}).

get_spain_consumer_prices

ChatGPT

Spain's consumer price index from the National Statistics Institute.

get_stochastic_rsi

ChatGPT

Stochastic relative strength index of one symbol, a faster momentum oscillator.

get_stock_news

ChatGPT

Recent news headlines about one company or ticker symbol. Use when the user asks what is happening with a specific company.

get_stock_performance

ChatGPT

Trailing returns of one symbol over standard windows, from one day to the maximum history.

get_stock_quotes

ChatGPT

Current price, change, day range and volume for up to 20 symbols at once: stocks, ETFs, indices, currency pairs or futures. Use when the user asks what something trades at now.

get_stock_statistics

ChatGPT

Key statistics for one stock: valuation multiples, market capitalisation, margins, dividend yield, share counts and similar figures.

get_technical_summary

ChatGPT

A summary of common technical indicators for one symbol (moving averages, momentum, trend). Use for a quick technical read; use the single-indicator tools for a full series.

get_timeseries

ChatGPT

Bounded timeseries for an entity: price, macro_series, etf_flows or etf_monthly_flows. Returns points oldest-first with an explicit downsampling flag when the raw series exceeded max_points. Times are UTC. Costs 1 unit per call. Read the step from `served_granularity, not granularity

. The latter echoes the request; the former is the step the source built the points at, and the two can differ (a long price range can come back as monthly bars under a "1d" request). It reads

mixed when the points do not share one step, unknown

 when the source does not say, and null when no point came back. It describes how each point was built, not how far apart the returned points are: a thinned daily series still reads

1d, and downsampled is what says points were dropped. The two ETF flow metrics answer different questions and are not interchangeable. etf_flows is an ESTIMATE at filing cadence: one point per SEC filing refresh, so t is a filing date and even a wide window yields a handful of points. etf_monthly_flows is the fund's own creations and redemptions from its NPORT-P filing, so t is a calendar month (YYYY-MM

) and each point carries the three filed components - sales, reinvestment, redemption - beside the net. Two things to read before quoting etf_monthly_flows. NPORT-P is filed per SERIES, so for a fund with more than one share class the figures cover every class and the payload says so in

multi_class_series; where the class count is unknown it says class_scope

 instead of staying silent. And a fund that files no NPORT-P at all, such as a commodity trust, is not an error: the call returns status

partial with an empty point list and a reason`. Args: metric: One of price / macro_series / etf_flows / etf_monthly_flows. entity: Entity dict from resolve_entity ({"namespace": ..., "ids": ...}). granularity: Requested point granularity (default "1d"). max_points: Hard cap on returned points (default 500).

get_trade_flows

ChatGPT

A country's exports and imports with a partner (or the world) for a year, optionally by product group, from World Bank trade statistics.

get_treasury_auction_results

ChatGPT

Results of recent US Treasury auctions with demand measures such as bid-to-cover.

get_treasury_rates

ChatGPT

Daily US Treasury rate series (par yield curve, bill rates, real yields and others) for a year or date range.

get_treasury_yield_curve

ChatGPT

US Treasury yield curve for a date: the yield at each maturity, nominal or real.

get_trending_news_entities

ChatGPT

People and organisations most mentioned in world news over a recent period.

get_tropical_cyclones

ChatGPT

Active tropical cyclones, hurricanes and typhoons, optionally by ocean basin.

get_tsunami_messages

ChatGPT

Active tsunami warnings, advisories and information messages.

get_uk_short_positions

ChatGPT

UK stocks with the largest disclosed short positions, from the Financial Conduct Authority.

get_unemployment_by_demographics

ChatGPT

Unemployment rates by country, sex and age group from the International Labour Organization.

get_upcoming_treasury_auctions

ChatGPT

Calendar of upcoming US Treasury auctions.

get_us_federal_spending

ChatGPT

US federal government spending over time by fiscal year, quarter or month.

get_us_recession_dates

ChatGPT

Official US business cycle peaks and troughs that date recessions.

get_us_trade_flows

ChatGPT

Monthly US exports or imports with a partner country, optionally by commodity, from the US Census Bureau.

get_volatility_index_history

ChatGPT

Daily history of a market volatility or options-based index by symbol.

get_volcanic_eruptions

ChatGPT

Recorded volcanic eruptions, filtered by country, years and explosivity.

list_congress_bills

ChatGPT

Bills introduced in the US Congress, by Congress number and bill type.

list_event_contracts

ChatGPT

Events listed on Kalshi, a regulated US exchange for event contracts, with their markets and implied probabilities. Read-only market data.

list_filings_by_form

ChatGPT

SEC filings of one form type filed on a given day, across all companies.

list_japan_filings_by_date

ChatGPT

All filings submitted to EDINET on one date, optionally only listed companies or one document type.

list_prediction_markets

ChatGPT

Individual Polymarket markets, open or closed, sorted as requested. Read-only market data.

list_settled_event_contracts

ChatGPT

Kalshi markets that have already settled, with their outcomes. Read-only market data.

list_sources

ChatGPT

List source families in the bundled catalog with endpoint counts. Use the family names as the source filter on search_endpoints. This does not call the Sugra API.

list_toolsets

ChatGPT

List catalog groups with endpoint counts and short descriptions. Use the group names as the toolset filter on search_endpoints. This does not call the Sugra API; it reads the bundled catalog.

resolve_entity

ChatGPT

Resolve free text to a canonical market or macro entity. Turns a ticker, company name, macro indicator, coin, or currency pair into the agent plane's `{namespace, ids}` entity for use with get_snapshot and get_timeseries. A cross-namespace collision (e.g. a ticker that is both an equity and a coin) returns status "ambiguous" with ranked candidates and NEVER silently picks one; pass type_hint (e.g. "equity", "etf", "coin") to narrow the universe. Crypto aliases resolve too (e.g. "bitcoin" -> the BTC coin entity). Status "low_confidence" means the best match cleared resolution but scored weakly - verify the returned entity before building on it, or re-query with a more specific name or type_hint. For compliance KYB lookups by LEI/VAT or sanctions screening use sugra_entity_lookup / sugra_entity_screen instead - this tool is for market-data entities. Args: query: Free-form text - ticker, company, indicator, coin, or pair. type_hint: Optional namespace hint narrowing resolution.

search_airports

ChatGPT

Find airports by name, country, type or airport code.

search_company_filings

ChatGPT

Full-text search across SEC filings for a word or phrase, optionally limited by form type and date range.

search_dex_pairs

ChatGPT

Find token trading pairs on decentralised exchanges by token name, symbol or address.

search_economic_series

ChatGPT

Find FRED economic time series by words, to get the series identifier for get_economic_series.

search_equities

ChatGPT

Find listed companies by sector, industry, country, exchange, size or name.

search_etfs

ChatGPT

Find exchange-traded funds by category, fund family, exchange or name.

search_eu_product_codes

ChatGPT

Find Eurostat product codes by product name, for use with get_eu_production_sales.

search_futures_positioning_markets

ChatGPT

Find futures market names covered by the US Commodity Futures Trading Commission positioning reports.

search_health_indicators

ChatGPT

Find World Health Organization health indicators by name, to get the code for get_health_indicator.

search_japan_companies

ChatGPT

Find Japanese companies registered with EDINET by name or code.

search_legal_entities

ChatGPT

Find companies and other legal entities in the global Legal Entity Identifier register by legal name and country.

search_prediction_markets

ChatGPT

Search prediction markets on Polymarket and other venues by topic, to see the market-implied probability of an event. Read-only market data.

search_preprints

ChatGPT

Search arXiv research preprints by words, category, author or title.

search_scholarly_works

ChatGPT

Search published scholarly works (articles, books, datasets) by words, author, title or date.

search_tickers

ChatGPT

Find ticker symbols by company or instrument name. Use when the user names a company and the symbol is not known.

sugra_entity_lookup

ChatGPT

Resolve an entity by identifier and return its composed KYB envelope. anchor is lei (Legal Entity Identifier, resolved via the GLEIF registry) or vat (EU VAT number, validated via the EU VIES service). The result weaves identity, a sanctions screening signal, and - on request - ownership and adverse-media slices. The screening verdict is a SCREENING SIGNAL, not a compliance determination, and any PEP / adverse-media content is supplementary and non-comprehensive. The disclaimer field carries this and is always present. Output is COMPACT by default to protect the agent context budget:

{entity:{name, anchor, value, status, country}, screening:{status, top_matches:[...3], hit_count}, ids:{...}, disclaimer}

. Pass include to opt INTO fuller per-slice detail, e.g. include=["ownership","adverse_media"] adds those slices in full form. On a bad anchor or an API error this returns a clean {error, detail} dict rather than raising, so the agent can branch on result.get("error"). Args: anchor: Identifier type, one of lei or vat. value: The identifier value (the 20-char LEI code or the VAT number). include: Optional list of fuller slices to add, e.g. ["ownership", "adverse_media"]. Omit for the compact default.

sugra_entity_screen

ChatGPT

Screen a person or organization name against the Sugra sanctions corpus. Returns a SCREENING SIGNAL, not a compliance determination. Sugra is a technology provider, not a sanctions authority or consumer reporting agency. PEP and adverse-media coverage is supplementary and non-comprehensive - a clear result is not proof of absence, and a hit is a candidate match to review, not a finding. Output is COMPACT to protect the agent context budget: {status, matches:[{name, score, list, type}], disclaimer}. The verdict status is one of clear, review, or hit. The heavy raw fields (match rationale, source ids, publish dates) are dropped; use the Sugra API directly when the full screening envelope is needed. Args: name: The person or organization name to screen (required). country: Optional ISO 3166-1 alpha-2 country to narrow the match. dob: Optional date of birth (YYYY-MM-DD) for a person. nationality: Optional nationality to narrow the match.

call_endpoint

Claude

describe_endpoint

Claude

fetch_data

Claude

get_snapshot

Claude

get_timeseries

Claude

list_sources

Claude

list_toolsets

Claude

resolve_entity

Claude

search_endpoints

Claude

sugra_entity_lookup

Claude

sugra_entity_screen

Claude

Links

Documentation ↗Privacy Policy ↗

App Stats

160

Tools

ChatGPT, Claude

Platforms