API / Piattaforma

Architettura della piattaforma e
panoramica completa delle capacità.

Come 1307 endpoint distribuiti su 111 fonti primarie si integrano in un’unica connessione unificata. Aggregazione, failover, normalizzazione, involucro pronto per LLM - e l’elenco completo di ciò che l’API copre, dominio per dominio.

Documentazione API → Vedi prezzi
Architettura

Una chiamata. Ogni dominio. Sempre lo stesso output.

Sugra API si colloca tra la vostra applicazione e ogni fonte di dati che altrimenti dovreste integrare, mantenere e monitorare singolarmente. Voi effettuate una chiamata. Noi gestiamo il resto. Routing delle fonti, failover, normalizzazione e caching avvengono all’interno del livello. Ciò che ricevete è sempre lo stesso JSON strutturato - indipendentemente dalla fonte che lo ha consegnato.

Aggregazione multi-fonte

Dati da una rete in crescita di fonti primarie - azioni, documenti societari, economia, cripto, valute, materie prime, agricoltura, clima, mercati di previsione, economia digitale, ambiente e notizie globali. Un’unica integrazione. Tutte le fonti.

Failover automatico

Se una fonte di dati va offline, la successiva fonte disponibile subentra in modo trasparente. Nessuna modifica richiesta dalla vostra parte. Nessun downtime dovuto a guasti a monte.

Formato di output unificato

Ogni endpoint restituisce JSON strutturato indipendentemente dalla fonte sottostante. Costruite una volta. Aggiungete nuovi domini di dati senza toccare la vostra integrazione.

Pronto per LLM by design

Involucro coerente (data + meta), timestamp delle fonti e tipi semantici di unità in ogni risposta. Inseritelo direttamente in un agente o modello, senza alcuna trasformazione. Inoltre un server Model Context Protocol nativo - collegate Anthropic Claude, OpenAI GPT, Google Gemini, xAI o qualsiasi client MCP in una sola riga.

Cosa copre l’API

Panoramica completa delle capacità.

1307 endpoint, 22 domini di dati, 111 fonti primarie. Ecco cosa si trova dietro un’unica integrazione.

Finanza - Prezzi e Storico
  • Prezzo attuale - bid, ask, volume, capitalizzazione di mercato, range a 52 settimane
  • OHLCV storico - 1d fino al massimo, o intervallo di date personalizzato
  • Dividendi - rendimento, tasso, ex-date, data dell’ultimo pagamento
  • Operazioni societarie - split e dividendi, filtrabili per giorni
  • Codice ISIN - identificatore ISO 6166
  • Batch multi-simbolo - fino a 10 simboli, tipo info o history
Finanza - Utili e Stime
  • Storico utili - EPS effettivo vs stima, differenza, % di sorpresa
  • Stime previsionali - utili e ricavi per periodo (0q/+1q/0y/+1y)
  • Calendario utili - prossimi utili e date di dividendi
  • Date utili - cronologia completa degli annunci
  • Bilanci - conto economico, stato patrimoniale, flussi di cassa (annuali e trimestrali)
Finanza - Analisti e Proprietà
  • Target degli analisti - consenso, minimo, massimo, prezzo obiettivo medio e numero
  • Upgrade/downgrade - modifiche di rating negli ultimi 6 mesi
  • Raccomandazioni - aggregato buy/hold/sell nel tempo
  • Principali azionisti - distribuzione % tra insider, istituzionali e fondi
  • Detentori istituzionali - posizioni delle principali istituzioni e numero di azioni
  • Detentori fondi comuni - posizioni dei principali fondi
  • Elenco insider - insider nominati e ruoli
  • Transazioni insider - attività di acquisto/vendita con date e valori
Finanza - Opzioni e Tecnica
  • Scadenze opzioni - tutte le date di scadenza disponibili per un simbolo
  • Catena opzioni - call e put completi per qualsiasi scadenza, con IV, greche, volume, open interest
  • Analisi tecnica - segnale buy/sell/neutral, oscillatori, medie mobili, 9 intervalli (da 1m a 1M)
  • Profilo del fondo - panoramica ETF, classi di attivi, principali partecipazioni, pesi settoriali
  • Documenti SEC - documenti EDGAR con link diretti di download, filtrabili per giorni
  • Prezzi obiettivo - ultimi 3 mesi
Economia - Dati per paese
  • Panoramica paesi - matrice heatmap globale per ~190 paesi
  • Indicatori completi del paese - tutte le sezioni in una sola chiamata per paese
  • Sezione GDP - crescita, dimensione, debito, deficit, conto corrente
  • Sezione lavoro - disoccupazione, salari, tasso di occupazione, produttività
  • Sezione prezzi - CPI, tasso di inflazione, prezzi alimentari e abitativi
  • Moneta, commercio, governo, salute, business, consumi, abitazioni - endpoint dedicati per sezione e paese
  • Campi per riga - Last, Previous, Change, ChangePercent, Highest, Lowest, Unit, Reference
  • Filtro per parola chiave - tramite parametro ?Related=
FRED Macro - Serie storiche
  • USA (18 serie) - 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
  • Eurozona, Regno Unito, Giappone - CPI, Unemployment, GDP per regione
  • Trasformazioni semantiche - mom_pct, yoy_pct, qoq_ann_pct, dod_bps, wow_bps, mom_pp, yoy_pp, mom_abs, yoy_abs - validate per unit_type della serie
  • Modalità - ultime N osservazioni o intervallo di date
  • Endpoint batch - fino a 5 serie in una chiamata, errori isolati
  • Meta - last_updated, range effettivo, lookback di trasformazione, stato cache
Meteo e Marina
  • Condizioni attuali - temperatura, vento, precipitazioni, umidità per qualsiasi località
  • Previsione giornaliera - fino a 16 giorni in anticipo, copertura globale
  • Meteo storico - dati giornalieri dal 1940 a oggi
  • Geocoding - ricerca di coordinate per nome di città
  • Allerte USA - allerte meteo attive tramite NOAA NWS
  • Previsione USA - 7 giorni e oraria (solo USA)
  • Condizioni marine - altezza delle onde, correnti oceaniche, temperatura della superficie del mare
  • Previsione marina - giornaliera e oraria, fino a 7 giorni
Clima e Qualità dell’aria
  • Clima storico - 70 anni di dati di tendenze climatiche, copertura globale
  • Proiezioni climatiche - proiezioni dei modelli CMIP6 fino al 2050
  • Modelli disponibili - elenco dei modelli climatici CMIP6 supportati
  • Qualità dell’aria attuale - PM2.5, PM10, NO2, ozono, indici AQI europeo e statunitense
  • Previsione qualità aria - previsione oraria, copertura globale
Materie prime e Forex
  • Catalogo materie prime - elenco completo delle materie prime disponibili
  • Prezzi attuali - prezzi attuali su 18 materie prime
  • Energia - petrolio (Brent e WTI), prezzi del gas naturale, scorte di petrolio USA
  • Agricoltura - grano, mais, soia, riso, caffè, zucchero, cotone, gomma
  • Metalli - oro, argento, platino, rame, alluminio, minerale di ferro
  • Storico materie prime - prezzi storici per ID di materia prima
  • Forex attuale - tassi di riferimento basati su EUR per ~30 valute
  • Conversione Forex - endpoint di conversione valutaria
  • Storico Forex - tassi di cambio storici, ultimi 90 giorni
  • Tassi CBR - tassi di riferimento basati su RUB
Banche centrali e Stabilità finanziaria
  • Tassi di politica - 49 banche centrali nel mondo
  • Gap credito-GDP - indicatore di stabilità finanziaria
  • Rapporti di servizio del debito - 32 paesi
  • Prezzi immobiliari - residenziale e commerciale, 61 paesi
  • Tassi di cambio effettivi - REER/NEER, 64 paesi
  • Bilanci delle banche centrali - attivi totali
  • Liquidità globale - indicatori di credito transfrontaliero
Documenti societari - Giappone
  • Relazioni annuali - finanze XBRL (conto economico, stato patrimoniale, flussi di cassa)
  • Relazioni trimestrali - finanze cumulative YTD
  • Partecipazioni rilevanti - comunicazioni di possesso 5%+
  • Offerte pubbliche - documenti M&A
  • Controllo interno - valutazione J-SOX
  • Azioni proprie - rapporti di buyback
  • 42 tipi di documenti - supporto J-GAAP e IFRS
Governo USA
  • Debito nazionale - giornaliero, storico dal 1790
  • Spesa federale - 111 agenzie, per stato
  • Aste del Tesoro - dal 1979, CUSIP, rendimenti
  • Riserve aurifere - per luogo di stoccaggio
  • Deficit di bilancio - entrate e uscite mensili
  • Tassi di interesse - tassi medi sui titoli del Tesoro
Agricoltura e Alimentazione
  • Produzione agricola - 245+ paesi, dal 1961
  • Commercio agricolo - importazioni/esportazioni per prodotto
  • Prezzi al produttore - prezzi delle materie prime agricole
  • Bilancio alimentare - offerta, utilizzo, pro capite
  • Emissioni - gas serra del settore agroalimentare
  • Sicurezza alimentare - malnutrizione, ritardo della crescita
  • Uso del suolo - agricolo, forestale, area arabile
Notizie globali e Media
  • Ricerca articoli - 100+ lingue, 250K+ fonti
  • Analisi del sentiment - distribuzione del tono per argomento
  • Cronologia copertura - volume e tendenza nel tempo
  • Estrazione frasi - testo reale con contesto
  • Ricerca TV - 2M+ ore dal 2009
Statistiche nazionali e Riferimento
  • Canada - 8,161 tabelle, CPI dal 1914
  • Australia - 1,223 dataset, CPI dal 1948
  • Bank of Japan - 326K serie, TANKAN
  • Bank of England - Bank Rate, SONIA, rendimenti gilt
  • Mappatura strumenti - ticker, ISIN, CUSIP, SEDOL verso FIGI
  • 28 tipi di identificatori - tutte le borse globali
Previsioni e Mercati di eventi
  • Mercati politici - elezioni, legislazione, probabilità di policy
  • Mercati macro - tassi, inflazione, esiti GDP
  • Borsa regolamentata CFTC - contratti e prezzi Kalshi
  • Mercati decentralizzati - liquidità di previsione on-chain
  • Profondità del book - prezzi yes/no, volume, open interest
Economia digitale e Infrastruttura
  • DeFi TVL - protocolli, stablecoin, DEX, rendimenti, opzioni
  • Rete Bitcoin - mempool, commissioni, hashrate, stato UTXO
  • Metriche on-chain - indirizzi attivi, salute della rete
  • Routing Internet - BGP, ricerche ASN, rilevamento globale di interruzioni
  • Trasparenza certificati - emissione di domini, log CT
  • Sonde di rete - infrastruttura globale di misurazione
  • Reti di anonimizzazione - utilizzo Tor, metriche dei relay
Ambiente e Catastrofi
  • Terremoti - feed globale USGS, magnitudo, profondità
  • Incendi attivi - rilevamento satellitare NASA FIRMS
  • Vulcani - catalogo USGS ed eventi eruttivi
  • Catastrofi globali - allerte GDACS per tipologie di rischio
  • Meteo spaziale - NOAA SWPC solare e geomagnetico
  • Centrali elettriche - 34,936 impianti in 167 paesi
  • Attività navale - pesca, rapporti EEZ, traffico marittimo
Finanza Economia Macro Fondamentali Materie prime Cripto Forex Previsioni Economia digitale Ambiente Meteo e Marina Clima Notizie globali e 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 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

Documentazione completa con parametri di richiesta e risposte di esempio su docs.sugra.ai.

Copertura

Borse e mercati.

62 borse in 49 paesi - 49 con copertura completa, 7 parziali, 6 nella roadmap di integrazione nativa. Elenco completo leggibile da macchina su sugra.ai/api/v1/exchanges.

Americas
  • Nasdaq ok
  • New York Stock Exchange ok
  • NYSE Arca ok
  • Cboe BZX Exchange ok
  • OTC Markets ok
  • Nasdaq BX ok
  • Toronto Stock Exchange ok
  • TSX Venture Exchange ok
  • Canadian Securities Exchange ok
  • B3 - Brasil Bolsa Balcao ok
  • Bolsa Mexicana de Valores ok
  • Bolsa de Comercio de Buenos Aires ok
  • Santiago Stock Exchange ok
Europe Western
  • London Stock Exchange ok
  • Deutsche Boerse Xetra ok
  • Frankfurt Stock Exchange ok
  • Euronext Paris ok
  • Euronext Amsterdam ok
  • Euronext Brussels ok
  • Euronext Dublin ok
  • Euronext Lisbon ok
  • Borsa Italiana ok
  • BME - Bolsas y Mercados Espanoles ok
  • SIX Swiss Exchange ok
  • Wiener Borse ok
Europe Nordic & Baltic
  • Nasdaq Stockholm ok
  • Oslo Bors ok
  • Nasdaq Copenhagen ok
  • Nasdaq Helsinki ok
  • Nasdaq Iceland partial
  • Nasdaq Tallinn partial
  • Nasdaq Riga partial
  • Nasdaq Vilnius partial
Europe Central & East
  • Warsaw Stock Exchange ok
  • Bucharest Stock Exchange gap
  • Moscow Exchange gap
  • Ukrainian Exchange gap
Asia Developed
  • Tokyo Stock Exchange ok
  • Hong Kong Exchanges ok
  • Korea Exchange (KOSPI) ok
  • KOSDAQ ok
  • Taiwan Stock Exchange ok
  • Taipei Exchange (OTC) ok
  • Singapore Exchange ok
Asia Emerging
  • Shenzhen Stock Exchange ok
  • Shanghai Stock Exchange ok
  • National Stock Exchange of India ok
  • BSE India ok
  • Indonesia Stock Exchange ok
  • Stock Exchange of Thailand ok
  • Bursa Malaysia ok
  • Philippine Stock Exchange partial
  • Ho Chi Minh Stock Exchange (HOSE) gap
Oceania
  • Australian Securities Exchange ok
  • NZX Main Board ok
MEA
  • Johannesburg Stock Exchange ok
  • Tel Aviv Stock Exchange ok
  • Borsa Istanbul ok
  • Saudi Exchange (Tadawul) partial
  • Dubai Financial Market gap
  • Abu Dhabi Securities Exchange gap
  • Egyptian Exchange partial

Stato: OK - copertura completa da fonte primaria. Partial - copertura presente, liquidità inferiore o listing ridotti. Gap - integrazione nativa pianificata, attualmente non disponibile.

Documentazione

Iniziate a costruire.

Documentazione API
Riferimento completo con parametri di richiesta, risposte di esempio e playground interattivo. Copre Finanza, Economia, Macro, Fondamentali, Cripto, Forex, Materie prime, Meteo, Clima, Previsioni, Economia digitale, Ambiente, Notizie globali e altro ancora.
docs.sugra.ai
Server MCP
Server Model Context Protocol nativo per agenti IA. Funziona con Anthropic Claude, OpenAI GPT, Google Gemini, xAI e qualsiasi IDE compatibile con MCP. Collegatevi direttamente a app.sugra.ai/mcp o installate il client tramite pip install sugra-api-mcp.
app.sugra.ai/mcp
Pagina di stato
Stato operativo in tempo reale per ogni componente, cronologia uptime di 90 giorni, incidenti attivi e passati. Infrastruttura indipendente, API JSON pubblica e feed RSS per strumenti di monitoraggio.
status.sugra.ai
Chi siamo

Realizzato da Sugra Systems, Inc.

Sugra API è il livello dati della piattaforma Sugra - alimenta Sugra AI, Sugra Assist e Sugra App. La stessa infrastruttura è disponibile per sviluppatori esterni e aziende che necessitano di dati affidabili e multi-dominio in un unico canale unificato.

Abbiamo iniziato a lavorare con l’IA in applicazioni finanziarie nel 2020, tramite Microsoft for Startups, prima dell’inizio del ciclo IA attuale. We were early. We were right.

Contatti

Interessati all’accesso API?

Che si tratti di integrare dati di mercato nel vostro prodotto, costruire su agenti IA o esplorare una soluzione dati personalizzata per FinTech o telecomunicazioni - scriveteci. Rispondiamo entro un giorno lavorativo.