API / Plataforma

Arquitetura da plataforma e
detalhamento completo de capacidades.

Como 1307 endpoints distribuídos por 111 fontes primárias se encaixam em uma única integração unificada. Agregação, failover, normalização, envelope pronto para LLM - e a lista completa do que a API cobre, domínio por domínio.

Documentação API → Ver preços
Arquitetura

Uma chamada. Qualquer domínio. Sempre a mesma saída.

A Sugra API fica entre o seu aplicativo e cada fonte de dados que, de outra forma, você teria que integrar, manter e monitorar individualmente. Você faz uma chamada. Nós cuidamos do resto. Roteamento de fontes, failover, normalização e cache acontecem dentro da camada. O que você recebe é sempre o mesmo JSON estruturado - independentemente de qual fonte o entregou.

Agregação multi-fonte

Dados de uma rede crescente de fontes primárias - ações, registros corporativos, economia, cripto, câmbio, commodities, agricultura, clima, mercados de previsão, economia digital, meio ambiente e notícias globais. Uma integração. Todas as fontes.

Failover automático

Se uma fonte de dados cair, a próxima fonte disponível assume de forma transparente. Sem mudanças no seu lado. Sem tempo de inatividade por falhas a montante.

Formato de saída unificado

Cada endpoint retorna JSON estruturado independentemente da fonte subjacente. Construa uma vez. Adicione novos domínios de dados sem tocar na sua integração.

Pronto para LLM por design

Envelope consistente (data + meta), timestamps de origem e tipos semânticos de unidades em cada resposta. Conecte diretamente em um agente ou modelo sem transformação. Além de um servidor Model Context Protocol nativo - conecte Anthropic Claude, OpenAI GPT, Google Gemini, xAI ou qualquer cliente MCP em uma linha.

O que a API cobre

Detalhamento completo de capacidades.

1307 endpoints, 22 domínios de dados, 111 fontes primárias. Eis o que está por trás de uma única integração.

Finanças - Preços e Histórico
  • Preço atual - bid, ask, volume, capitalização de mercado, faixa de 52 semanas
  • OHLCV histórico - 1d até máx, ou intervalo de datas personalizado
  • Dividendos - rendimento, taxa, ex-date, data do último pagamento
  • Eventos corporativos - splits e dividendos, filtráveis por dias
  • Código ISIN - identificador ISO 6166
  • Lote multi-símbolo - até 10 símbolos, tipo info ou history
Finanças - Lucros e Estimativas
  • Histórico de lucros - EPS real vs estimado, diferença, % de surpresa
  • Estimativas futuras - lucros e receita por período (0q/+1q/0y/+1y)
  • Calendário de resultados - próximos resultados e datas de dividendos
  • Datas de resultados - cronograma histórico completo de anúncios
  • Demonstrações financeiras - DRE, balanço, fluxo de caixa (anuais e trimestrais)
Finanças - Analistas e Propriedade
  • Metas de analistas - consenso, mínimo, máximo, preço-alvo médio e quantidade
  • Upgrades/downgrades - mudanças de classificação nos últimos 6 meses
  • Recomendações - agregado buy/hold/sell ao longo do tempo
  • Principais acionistas - distribuição % entre insiders, institucionais e fundos
  • Detentores institucionais - posições das principais instituições e número de ações
  • Detentores de fundos - posições dos principais fundos
  • Lista de insiders - insiders nomeados e cargos
  • Transações de insiders - compra/venda com datas e valores
Finanças - Opções e Técnicas
  • Vencimentos de opções - todas as datas de vencimento disponíveis para um símbolo
  • Cadeia de opções - calls e puts completos para qualquer vencimento, com IV, gregas, volume, interesse em aberto
  • Análise técnica - sinal buy/sell/neutral, osciladores, médias móveis, 9 intervalos (1m a 1M)
  • Perfil do fundo - visão geral ETF, classes de ativos, principais holdings, ponderação setorial
  • Documentos SEC - documentos EDGAR com links diretos de download, filtráveis por dias
  • Preços-alvo - últimos 3 meses
Economia - Dados por país
  • Visão geral de países - matriz heatmap global para ~190 países
  • Indicadores completos do país - todas as seções em uma chamada por país
  • Seção GDP - crescimento, tamanho, dívida, déficit, conta corrente
  • Seção trabalho - desemprego, salários, taxa de emprego, produtividade
  • Seção preços - CPI, taxa de inflação, preços de alimentos e habitação
  • Dinheiro, comércio, governo, saúde, negócios, consumo, habitação - endpoints dedicados de seção por país
  • Campos por linha - Last, Previous, Change, ChangePercent, Highest, Lowest, Unit, Reference
  • Filtragem por palavra-chave - via parâmetro ?Related=
FRED Macro - Séries Temporais
  • EUA (18 séries) - 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
  • Zona do euro, Reino Unido, Japão - CPI, Unemployment, GDP por região
  • Transformações semânticas - mom_pct, yoy_pct, qoq_ann_pct, dod_bps, wow_bps, mom_pp, yoy_pp, mom_abs, yoy_abs - validadas pelo unit_type da série
  • Modos - últimas N observações ou intervalo de datas
  • Endpoint em lote - até 5 séries em uma chamada, erros isolados
  • Meta - last_updated, faixa efetiva, lookback de transformação, status do cache
Tempo e Marinha
  • Condições atuais - temperatura, vento, precipitação, umidade para qualquer local
  • Previsão diária - até 16 dias à frente, cobertura global
  • Tempo histórico - dados diários de 1940 até o presente
  • Geocodificação - busca de coordenadas pelo nome da cidade
  • Alertas EUA - alertas meteorológicos ativos via NOAA NWS
  • Previsão EUA - 7 dias e horária (apenas EUA)
  • Condições marítimas - altura das ondas, correntes oceânicas, temperatura da superfície do mar
  • Previsão marítima - diária e horária, até 7 dias
Clima e Qualidade do Ar
  • Clima histórico - 70 anos de dados de tendências climáticas, cobertura global
  • Projeções climáticas - projeções de modelos CMIP6 até 2050
  • Modelos disponíveis - lista de modelos climáticos CMIP6 suportados
  • Qualidade do ar atual - PM2.5, PM10, NO2, ozônio, índices AQI europeu e dos EUA
  • Previsão da qualidade do ar - previsão horária, cobertura global
Commodities e Forex
  • Catálogo de commodities - lista completa de commodities disponíveis
  • Preços atuais - preços atuais em 18 commodities
  • Energia - petróleo bruto (Brent e WTI), preços do gás natural, estoques de petróleo bruto dos EUA
  • Agricultura - trigo, milho, soja, arroz, café, açúcar, algodão, borracha
  • Metais - ouro, prata, platina, cobre, alumínio, minério de ferro
  • Histórico de commodities - preços históricos por ID da commodity
  • Forex atual - taxas de referência baseadas em EUR para ~30 moedas
  • Conversão Forex - endpoint de conversão de moedas
  • Histórico Forex - taxas de câmbio históricas, últimos 90 dias
  • Taxas CBR - taxas de referência baseadas em RUB
Bancos centrais e estabilidade financeira
  • Taxas de política - 49 bancos centrais no mundo
  • Gaps crédito-GDP - indicador de estabilidade financeira
  • Razões de serviço da dívida - 32 países
  • Preços imobiliários - residencial e comercial, 61 países
  • Taxas de câmbio efetivas - REER/NEER, 64 países
  • Balanços de bancos centrais - ativos totais
  • Liquidez global - indicadores de crédito transfronteiriço
Registros corporativos - Japão
  • Relatórios anuais - finanças XBRL (resultado, balanço, fluxo de caixa)
  • Relatórios trimestrais - finanças cumulativas YTD
  • Participação relevante - divulgações de propriedade de 5%+
  • Ofertas públicas - registros M&A
  • Controle interno - avaliação J-SOX
  • Ações em tesouraria - relatórios de recompra de ações
  • 42 tipos de documentos - suporte J-GAAP e IFRS
Governo dos EUA
  • Dívida nacional - diária, histórico desde 1790
  • Gastos federais - 111 agências, por estado
  • Leilões do Tesouro - desde 1979, CUSIP, rendimentos
  • Reserva de ouro - por local de armazenamento
  • Déficit orçamentário - receitas e despesas mensais
  • Taxas de juros - taxas médias sobre títulos do Tesouro
Agricultura e Alimentos
  • Produção agrícola - 245+ países, desde 1961
  • Comércio agrícola - importações/exportações por commodity
  • Preços ao produtor - preços de commodities agrícolas
  • Balanço alimentar - oferta, utilização, per capita
  • Emissões - gases de efeito estufa do setor agroalimentar
  • Segurança alimentar - desnutrição, retardo de crescimento
  • Uso da terra - agrícola, florestal, área arável
Notícias globais e Mídia
  • Busca de artigos - 100+ idiomas, 250K+ fontes
  • Análise de sentimento - distribuição do tom por tópico
  • Linha do tempo de cobertura - volume e tendência ao longo do tempo
  • Extração de sentenças - texto real com contexto
  • Busca em TV - 2M+ horas desde 2009
Estatísticas nacionais e Referência
  • Canadá - 8,161 tabelas, CPI desde 1914
  • Austrália - 1,223 conjuntos de dados, CPI desde 1948
  • Bank of Japan - 326K séries, TANKAN
  • Bank of England - Bank Rate, SONIA, rendimentos de gilts
  • Mapeamento de instrumentos - ticker, ISIN, CUSIP, SEDOL para FIGI
  • 28 tipos de identificadores - todas as bolsas globais
Previsões e Mercados de Eventos
  • Mercados políticos - eleições, legislação, probabilidades de políticas
  • Mercados macro - taxas, inflação, resultados de GDP
  • Bolsa regulada pela CFTC - contratos e preços Kalshi
  • Mercados descentralizados - liquidez de previsão on-chain
  • Profundidade do livro de ofertas - preços yes/no, volume, interesse em aberto
Economia digital e Infraestrutura
  • DeFi TVL - protocolos, stablecoins, DEX, rendimentos, opções
  • Rede Bitcoin - mempool, taxas, hashrate, estado UTXO
  • Métricas on-chain - endereços ativos, saúde da rede
  • Roteamento de Internet - BGP, buscas ASN, detecção global de quedas
  • Transparência de certificados - emissão de domínios, logs CT
  • Sondas de rede - infraestrutura global de medição
  • Redes de anonimização - uso do Tor, métricas de relés
Meio ambiente e Catástrofes
  • Terremotos - feed global USGS, magnitude, profundidade
  • Incêndios ativos - detecção via satélite NASA FIRMS
  • Vulcões - catálogo USGS e eventos de erupção
  • Catástrofes globais - alertas GDACS por tipo de risco
  • Clima espacial - NOAA SWPC solar e geomagnético
  • Usinas elétricas - 34,936 instalações em 167 países
  • Atividade de embarcações - pesca, relatórios de EEZ, tráfego marítimo
Finanças Economia Macro Fundamentos Commodities Cripto Forex Previsões Economia digital Meio ambiente Tempo e Marinha Clima Notícias globais e Mídia 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

Documentação completa com parâmetros de requisição e respostas de exemplo em docs.sugra.ai.

Cobertura

Bolsas e mercados.

62 bolsas em 49 países - 49 com cobertura completa, 7 parciais, 6 no roadmap de integração nativa. Lista completa legível por máquina em 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

Status: OK - cobertura completa de fonte primária. Partial - cobertura existe, menor liquidez ou listagens reduzidas. Gap - integração nativa planejada, atualmente indisponível.

Sobre

Construído pela Sugra Systems, Inc.

Sugra API é a camada de dados da plataforma Sugra - alimenta Sugra AI, Sugra Assist e Sugra App. A mesma infraestrutura está disponível para desenvolvedores externos e empresas que precisam de dados confiáveis e multi-domínio em um único canal unificado.

Começamos a trabalhar com IA em aplicações financeiras em 2020, através do Microsoft for Startups, antes do início do ciclo atual de IA. We were early. We were right.

Entre em contato

Interessado em acesso à API?

Seja para integrar dados de mercado em seu produto, construir sobre agentes de IA ou explorar uma solução de dados personalizada para FinTech ou telecom - escreva-nos. Respondemos em um dia útil.