EDI Analytics API

Acesso programático aos mesmos motores que sustentam a plataforma EDI: resolução de valores mobiliários nos Estados Unidos, Brasil, México e Peru; cotações globais de fechamento; fundamentos padronizados com inteligência de períodos fiscais; matrizes as-of multidomínio; e execução assíncrona em lote. Uma requisição produz o mesmo número no Excel, em Python, no Quant Workstation e em um relatório agendado — a paridade é estrutural, não dependente de testes.

Início rápido

Autentique-se uma vez — o cookie de sessão carrega suas permissões de acesso em todas as chamadas subsequentes.

# 1. Faça login (armazena o cookie de sessão)
curl -c cookies.txt -X POST https://api.edi.finance/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@yourfirm.com", "password": "…"}'

# 2. Resolva identificadores em ids canônicos de entidade
curl -b cookies.txt -X POST https://api.edi.finance/api/analytics/v1/resolve \
  -H "Content-Type: application/json" \
  -d '{"identifiers": [{"value": "PETR4-BR"}, {"value": "AAPL"}]}'

# 3. Uma grade de comparáveis multimercado em USD, em uma única chamada
curl -b cookies.txt -X POST https://api.edi.finance/api/analytics/v1/matrix \
  -H "Content-Type: application/json" \
  -d '{"ids": ["AAPL-US","BBAS3-BR","BIMBOA-MX"],
       "metrics": ["close","MARKET_CAP","SECTOR"],
       "asOf": "2026-07-30", "currency": "USD"}'

Ou com o cliente de referência em Python:

from edi_analytics import EdiAnalyticsClient, spill_matrix

client = EdiAnalyticsClient("https://api.edi.finance")
client.login("you@yourfirm.com", "…")

env = client.matrix(ids=["AAPL-US", "BBAS3-BR"],
                    metrics=["close", "MARKET_CAP", "SECTOR"])
grid = spill_matrix(env, ids=["AAPL-US", "BBAS3-BR"],
                    metrics=["close", "MARKET_CAP", "SECTOR"])

Autenticação de serviço — chaves de API

Para scripts, SDKs e integrações servidor a servidor, crie uma chave de API (ela age em seu nome, com as suas permissões) e envie-a como X-API-Key ou Authorization: Bearer — sem cookies. As chaves são exibidas uma única vez na criação, podem expirar e são revogáveis; o gerenciamento de chaves sempre exige uma sessão autenticada, nunca uma chave.

# Crie uma chave (autenticado por sessão) e use-a onde quiser
curl -b cookies.txt -X POST https://api.edi.finance/api/analytics/v1/keys \
  -H "Content-Type: application/json" -d '{"label": "research pipeline", "expiresInDays": 365}'

curl -H "X-API-Key: edi_sk_…" -X POST https://api.edi.finance/api/analytics/v1/resolve \
  -H "Content-Type: application/json" -d '{"identifiers": [{"value": "AAPL"}]}'

Python: EdiAnalyticsClient("https://api.edi.finance", api_key="edi_sk_…") — dispense o login() por completo.

Conceitos fundamentais

O envelope

Todo endpoint de dados retorna o mesmo envelope de três partes. As linhas em data são planas e autodescritivas — serializam de forma idêntica para JSON, CSV e intervalos de spill do Excel.

{
  "data":   [ /* linhas planas de observação */ ],
  "errors": [ /* falhas no nível da linha — nunca uma falha da requisição */ ],
  "meta":   { "pagination": { "total": 412 }, "registryVersion": "2026.07.16.1A" }
}

Identificadores e o eco do requestId

Todo endpoint aceita diretamente identificadores de tipos mistos — tickers qualificados por mercado (PETR4-BR, BIMBOA-MX), tickers simples, ISINs, CUSIPs, CIKs e ids canônicos de entidade. Cada linha de resposta carrega tanto requestId (o seu identificador, exatamente como enviado — a chave de junção de volta para a célula da sua planilha ou o índice do seu dataframe) quanto entityId (a nossa chave canônica, estável através de mudanças de ticker e classes de ações).

Falha parcial é a norma

Um ticker inválido jamais pode derrubar uma pasta de trabalho de 500 células. Identificadores não resolvíveis, métricas desconhecidas e conversões sem cotação retornam como entradas em errors — cada uma com um requestId, um code estável e um detail legível — enquanto todas as demais linhas retornam normalmente.

Proveniência

Toda resposta informa a versão do registro de métricas que a precificou (meta.registryVersion), e as linhas carregam a moeda efetivamente retornada. Os números são auditáveis entre clientes: a mesma requisição produz o mesmo valor em qualquer lugar, por construção.

Vocabulário

Os parâmetros de requisição abaixo significam a mesma coisa em todo endpoint que os aceita.

Periodicidade (fundamentos)

basis seleciona o eixo de reapresentação: original (padrão) ou restated (em preparação — aguarda modelagem de vintages).

Frequência (cotações & séries)

Ajuste de preço

Moeda

currency tem como padrão LOCAL: os valores retornam em sua moeda nativa de cotação ou de reporte, informada por linha — uma planilha brasileira nunca recebe USD silenciosamente. Qualquer código ISO (USD, BRL, MXN, EUR, …) é convertido no servidor; veja conversão de moeda para saber qual taxa de câmbio se aplica em cada caso.

Resolução de valores mobiliários

A camada de identidade sob todas as demais chamadas. Envie até 2.000 identificadores de tipos mistos; receba de volta entidades canônicas com a estrutura empresa vs. listagem. Linhas que compartilham um entityId são classes de ações / listagens do mesmo emissor, enumeradas em listings.

// POST /api/analytics/v1/resolve
{ "identifiers": [ {"value": "PETR4-BR"}, {"value": "US0378331005"}, {"value": "037833100", "type": "CUSIP"} ] }

// 200 — uma linha por candidato
{ "data": [
    { "requestId": "PETR4-BR", "entityId": "BR-9512", "ticker": "PETR4",
      "market": "BR", "matchedBy": "ticker", "candidateCount": 1,
      "listings": [ {"ticker": "PETR3", "market": "BR"}, {"ticker": "PETR4", "market": "BR"} ] } ] }

• Tickers sem qualificação resolvem contra o seu mercado padrão e, na ausência dele, contra os EUA. Qualifique com um sufixo (-BR, -MX, -PE, -US) para ser explícito; tickers hifenizados como BRK-B permanecem intactos.
• candidateCount > 1 marca um identificador ambíguo — os endpoints de dados reportam esses casos como erros de linha em vez de adivinhar.
• O formato do identificador é classificado automaticamente; passe type (TICKER · ISIN · CUSIP · CIK · ENTITY_ID) para sobrescrever.

Catálogo de métricas

O registro oficial de todas as métricas que os motores conseguem calcular — o mesmo registro contra o qual executam o screener da plataforma, os painéis quant e a bancada de fórmulas, incluindo as métricas de fórmula personalizadas da sua organização. Faça autocompletar a partir daqui e uma requisição jamais nomeará uma métrica que os motores não conheçam.

Cada linha indica também seu lugar na taxonomia de métricas: folderPath (linhas sob Demonstrações financeiras, indicadores sob Índices e indicadores, uma pasta por família de índices, linhas como reportadas por regulador), kind, basis (standardized · as_reported · derived · observed), statement, market, industryProfiles (vazio significa todo tipo de emissor) e canonicalDataset, presente na cópia de um código que pertence a outro conjunto de dados. Os nomes trazem aliases em espanhol e português: ?search=d%C3%ADvida%20l%C3%ADquida encontra NET_DEBT.

Cada linha informa seu dataset, motor, tipo de valor, unidade, tipos de entidade suportados, tipos de tempo (as-of / série temporal), modos de período e status.

Cotações globais

OHLCV de fechamento em todos os mercados cobertos, com contenção de listagens cruzadas embutida: uma linha de São Paulo que compartilha o ticker com uma emissão americana jamais pode se emendar na série dos EUA. Observações duplicadas são deduplicadas em uma única linha canônica por pregão.

// POST /api/content/global-prices/v1/prices
{ "ids": ["BBAS3-BR"], "startDate": "2026-01-01", "endDate": "2026-07-30",
  "frequency": "M", "fields": ["price", "volume"] }

// 200 — observações de fim de mês, moeda nativa informada por linha
{ "data": [
    { "requestId": "BBAS3-BR", "entityId": "BR-1023", "date": "2026-06-30",
      "currency": "BRL", "price": 19.91, "volume": 31200400 }, … ] }

• fields: price · priceOpen · priceHigh · priceLow · volume. adjust seleciona a base de preço.
• Todos os onze valores de frequência são suportados, com corte por calendário e ancoragem na data inicial.
• Com um currency, cada observação é convertida pela taxa de câmbio à vista da data daquela observação; volume nunca é convertido.

Fundamentos

Dados fiscais padronizados com a inteligência de períodos da plataforma. O servidor é o dono da semântica de períodos — armazenamento como acumulado do ano, inferência do encerramento do exercício fiscal, derivação do Q4, janelas LTM — para que nenhuma fórmula precise sê-lo.

// POST /api/content/fundamentals/v1/fundamentals
{ "ids": ["AAPL-US"], "metrics": ["REVENUE"], "periodicity": "LTM",
  "fiscalPeriod": { "start": "2025-01-01", "end": "2026-07-30" } }

// 200 — receita móvel dos últimos doze meses em cada encerramento de trimestre fiscal
{ "data": [
    { "requestId": "AAPL-US", "metric": "REVENUE", "periodicity": "LTM",
      "fiscalYear": 2026, "fiscalPeriod": "Q2", "fiscalEndDate": "2026-03-28",
      "currency": "USD", "value": 451442000000 }, … ] }

• fiscalPeriod.start/end são datas de calendário; o servidor as resolve para períodos fiscais encerrados. Janela padrão: cinco anos para trás.
• As linhas reportam a moeda de reporte do emissor, ou a currency solicitada após conversão.
• Métricas desconhecidas são erros de linha por métrica; o restante da requisição ainda retorna.

Taxonomias de demonstrações, demonstrações completas e períodos fiscais

Três complementos de descoberta e consulta do endpoint de fundamentos:

// POST /api/content/fundamentals/v1/statements — uma chamada, a demonstração completa
{ "ids": ["BBAS3-BR"], "statement": "FULL", "asOf": "2026-07-30", "currency": "USD" }

Indicadores

POST /ratios — o catálogo de indicadores como série: uma aba inteira (group), ou indicadores nomeados de qualquer aba, com todas as linhas de fluxo lidas em uma mesma base de período. É a janela de Indicadores da aplicação web servida pela API — a mesma chamada ao motor, então um número aqui e um número lá não podem divergir. A matriz continua servindo qualquer indicador em uma única data de referência; este endpoint é para o histórico.

// POST /api/content/fundamentals/v1/ratios
{ "ids": ["AAPL-US", "BIMBOA-MX"], "ratios": ["GROSS_MARGIN", "ROE", "PB"],
  "periodBasis": "ltm", "scale": "quarterly" }

// 200 — uma linha por (id, indicador, período); um indicador de fluxo carrega a base em que foi lido
{ "data": [
    { "requestId": "AAPL-US", "ratio": "GROSS_MARGIN", "group": "profitability",
      "period": "FY2026 Q3", "periodEnd": "2026-06-27", "value": 0.4865,
      "valueType": "percent", "periodBasis": "ltm", "scale": "quarterly" },
    { "requestId": "AAPL-US", "ratio": "PB", "group": "valuation",
      "period": "2026-08-31", "periodEnd": "2026-08-31", "value": 43.05,
      "valueType": "multiple", "periodBasis": null, "scale": "monthly",
      "scaleClampReason": "tab_grid" }, … ],
  "errors": [] }

• period é um período fiscal (FY2026 Q3) nas grades fiscais e uma data ISO na grade de preços. periodEnd data cada linha, porque os períodos não são comparáveis entre emissores: o FY2026 Q3 da Apple terminou em 2026-06-27 e o de um exercício encerrado em dezembro terminou em 2026-09-30.
• valueType: "percent" é uma fração — uma margem bruta de 48,65% é 0.4865, o mesmo número que a matriz e o catálogo dão para o mesmo código.
• Retido não é ausente. A margem bruta de um banco e o empréstimos/depósitos de uma industrial voltam como erros de linha NO_DATA que dizem por quê; cada (id, indicador) pedido produz um valor ou um erro, nunca uma célula silenciosamente ausente.
• GET /ratios/fields lista cada indicador que o endpoint serve com sua aba, fórmula, tipo de valor, escalas e os tipos de emissor para os quais existe — leia-o antes de montar uma consulta.

Point-in-time

POST /point-in-time — fundamentos como eram conhecidos em uma data, para backtesting sem viés de antecipação (emissores dos EUA). Duas garantias: um período fiscal é invisível até a data de publicação do seu protocolo (o trimestre de dezembro da Apple não existe antes de 30 de janeiro), e se um número for reapresentado depois, serve-se o valor vigente em pitDate — as linhas trazem firstPublished, lastPublished (aditamentos) e valueVintage (as_known quando há vigência capturada; a captura de reapresentações acumula desde 2026-08-02). pitDataItems=true no catálogo lista as métricas com capacidade PIT. FY e QTR; componha LTM no cliente a partir de trimestres PIT.

Matriz

Muitos ativos × muitas métricas em uma única data as-of, em uma requisição — a primitiva da grade de comparáveis. As métricas podem misturar datasets livremente: cotações, fundamentos, múltiplos de valuation, medidas derivadas e atributos de texto retornam todos pelo mesmo envelope.

// POST /api/analytics/v1/matrix
{ "ids": ["AAPL-US", "BBAS3-BR", "BIMBOA-MX"],
  "metrics": ["close", "MARKET_CAP", "PE_LTM", "SECTOR"],
  "asOf": "2026-07-30", "currency": "USD" }

// 200 — uma célula por (id, métrica); as-of = última observação na data ou antes dela
{ "data": [
    { "requestId": "AAPL-US",   "metric": "MARKET_CAP", "dataset": "derived",
      "valueType": "currency", "value": 4925847973597 },
    { "requestId": "BBAS3-BR",  "metric": "close",  "dataset": "prices", "value": 4.11 },
    { "requestId": "BIMBOA-MX", "metric": "SECTOR", "dataset": "entity_attributes",
      "valueType": "text", "value": "Food & Beverage" } ] }

• Nomes de métrica que colidem entre datasets são resolvidos por uma precedência documentada — as demonstrações reportadas vencem. Passe um par {"metric": "…", "dataset": "…"} explícito para sobrescrever; GET /catalog/metrics informa quais datasets servem cada nome.
• Métricas de demonstrações financeiras aceitam periodMode: "fy" para valores do último exercício fiscal; use o endpoint de fundamentos para séries QTR/LTM/YTD de linhas das demonstrações, o endpoint de indicadores para séries de indicadores na base de período escolhida, ou as métricas de valuation pré-calculadas (PE_LTM, EV_EBITDA_LTM, …).
• Células cujo cálculo resulta em nulo ficam ausentes, não viram erro — uma planilha preenche #N/A.

Screener

Execute screens no mesmo motor do screener da plataforma — condições sobre métricas financeiras, métricas de preço, múltiplos de valuation e as métricas de fórmula personalizadas da sua organização, com filtros de setor, bolsa, país e universo. Endpoints complementares: POST /count retorna a contagem de correspondências sem materializar linhas (conecte-o a um indicador ao vivo de "N empresas correspondem"), e GET /fields lista todos os campos filtráveis.

// POST /api/content/screener/v1/search
{ "conditions": [ { "metric": "MARKET_CAP", "operator": "gt", "value": 100000000000 },
                  { "metric": "ROE", "operator": "gte", "value": 0.15 } ],
  "metrics": ["REVENUE", "PE"], "sortBy": "MARKET_CAP", "currency": "USD", "limit": 50 }

// 200 — uma linha por ativo correspondente; meta.pagination.total = total de correspondências
{ "data": [
    { "ticker": "AAPL", "entityId": "0000320193", "sector": "Technology",
      "nativeCurrency": "USD", "marketCap": 4925847973597,
      "metrics": { "REVENUE": 451442000000, "PE": 43.9 } }, … ] }

• Operadores: gt · gte · lt · lte · eq · neq. Uma empresa sem uma métrica condicionada é reprovada no screen.
• currency aqui tem como padrão USD (não LOCAL): os limiares de um screen comparam emissores entre si, o que exige uma moeda comum. As linhas ainda informam sua nativeCurrency; meta.fxRateDate divulga a data da taxa de câmbio utilizada.
• tickers restringe o universo de candidatos; batch:"Y" enfileira screens grandes pela execução em lote.
• Listagens canceladas são excluídas por padrão. Omitir excludeStatus aplica a leitura da plataforma de "não consta como morta": listagens cujo status é cancelled / cancelado são descartadas. Milhares de emissores americanos deslistados carregam seus últimos fundamentos (para o trabalho point-in-time), e um screen de indicadores listaria, de outro modo, empresas mortas desde 2012 — um teste de negociação recente não as pegaria, pois muitas ainda imprimem centavos no mercado de balcão. Passe excludeStatus: [] para incluí-las, ou status para selecionar por status explicitamente; tradedWithinDays continua sendo o teste de liquidez separado e opcional.

Screening em data passada

POST /api/content/screener/v1/point-in-time — roda um screening como ele teria rodado numa data passada. O screener normal é do tempo presente: rodá-lo com limiares antigos informa quais dos sobreviventes de hoje passariam hoje.

• Cada linha traz fiscalYear, fundamentalsPeriodEnd, fundamentalsPublished e availabilityBasis: o screening é reproduzível porque se vê qual arquivamento julgou cada papel.
• currency é USD por padrão e converte pela taxa da data consultada, não pela de hoje. Índices e percentuais nunca são convertidos.
• Um emissor cuja moeda não possa ser precificada naquela data é excluído e informado como erro FX_UNAVAILABLE, nunca comparado sobre outra base.

Fundos

Dados de fundos dos mercados locais no Brasil (mais de 65.000 fundos registrados), México e Peru, com as convenções de identificador que cada mercado realmente usa: fundos BR resolvem por CNPJ em qualquer formato (00.000.684/0001-21 ou 00000684000121), fundos MX e PE por ticker ou id de entidade. Quatro endpoints compartilham um único contrato:

Participações institucionais ficam em /api/content/ownership/v1: POST /holders retorna quem detém um ativo (por gestor: vale o último protocolo do trimestre-alvo — aditamentos prevalecem), e POST /manager-holdings retorna a carteira de um gestor pelo CIK. O universo completo de gestores declarantes (~9.000) está coberto para cada trimestre já vencido; como essas divulgações vencem 45 dias após o fim do trimestre, as listas de detentores usam por padrão o último trimestre totalmente vencido — passe includePartial: true durante a janela de protocolo para ver o trimestre em andamento. Os valores estão em USD; os pesos são percentual do valor reportado.

// POST /api/content/funds/v1/prices
{ "ids": ["00000684000121", "+TASAD1F1"], "fields": ["nav", "netAssets"],
  "startDate": "2026-01-01", "endDate": "2026-07-30", "frequency": "M", "currency": "USD" }

• As séries BR referem-se à classe principal do fundo; fundos PE carregam a moeda de cada emissão (PEN ou USD), informada por linha.
• currency converte os campos monetários (cota, patrimônio líquido, fluxos) pela taxa à vista de cada observação, exatamente como em cotações globais.

Dados de referência

Identidade histórica e o registro documental que a sustenta. Ambos respondem à mesma pergunta: o que este identificador significava naquela data — a chave de cruzamento que qualquer base histórica externa ao nosso universo precisa.

Histórico de identificadores

POST /api/content/reference/v1/identifier-history — cada ticker, ISIN, CUSIP, CIK, bolsa e MIC que um papel já carregou, com intervalos de vigência, desde 1926. Cada linha traz o código do evento corporativo que causou a mudança, de modo que uma troca de nome se distingue de uma fusão.

// POST /api/content/reference/v1/identifier-history
{ "ids": [ "AAPL" ], "asOf": "2019-06-28" }

• identifierTypes filtra por TICKER · ISIN · CUSIP · CIK · EXCHANGE · MIC · MIC_SEGMENT · SECURITY_DESCRIPTION — os mesmos termos que /resolve aceita, então um valor retornado pode ser reenviado como está.
• startDate/endDate selecionam intervalos vigentes em algum momento da janela, não os que começaram dentro dela.
• Vem do cadastro-mestre da EDI: listagens dos EUA. Qualquer outro mercado retorna erro de linha, não um resultado vazio — que seria indistinguível de «nunca mudou».

Índice de documentos regulatórios

POST /api/content/reference/v1/filings — 2,2 milhões de arquivamentos regulatórios dos EUA de 20.205 emissores desde 1993: tipo de formulário, data, fim do período, número de accession, tipo de emenda e URL do documento. O relógio de eventos para estratégias baseadas em anúncios, e a trilha de auditoria por trás de cada dado fundamental que servimos.

formTypes compara por prefixo: 10-K inclui 10-K/A. Uma emenda é o mesmo evento rearquivado, e costuma ser justamente a reapresentação procurada.

Fatores de ajuste de proventos

/corporate-actions agora retorna priceFactor, shareFactor, cashComponent, affectsSplitAdjusted, affectsTotalReturn e factorStatus ao lado dos termos do evento, para que você reconstrua sua própria série ajustada e a concilie com a nossa.

Calendários de negociação

POST /api/content/reference/v1/calendar — os pregões que cada mercado realmente opera, para EUA, BR, MX e PE, dos anos noventa até 2029. Os dias sem pregão trazem o motivo; use includeNonTrading para obter o calendário completo.

• origin é observed (um pregão com preços no nosso repositório), scheduled (derivado de regras, o único disponível para datas futuras) ou both. Quem planeja um rebalanceamento a dois anos consegue distinguir.
• Quando as regras e os preços divergem, a linha mantém o observado e informa o conflict. Um dia de luto nacional é anunciado, não deduzido de uma regra.
• session sinaliza os fechamentos antecipados dos EUA. Nenhum outro mercado os publica com confiabilidade suficiente para afirmarmos o mesmo.

Aritmética em dias de pregão

POST /api/content/reference/v1/calendar/offset — desloque N dias de pregão a partir de uma data âncora. Liquidação em T+2, agendamento de rebalanceamentos e janelas de eventos são a mesma pergunta, e todas ficam erradas quando respondidas em dias corridos.

• Um offset de 0 ajusta para o pregão vigente na âncora ou antes — o que significa uma data «as of» quando ela cai em feriado.
• Se o calendário acabar antes do deslocamento, resultDate é nulo e tradingDaysAvailable diz até onde chegou. Ajustar para a borda devolveria uma data plausível e errada.

Negociações de insiders

POST /api/content/ownership/v1/insider-transactions — 1,75 milhão de registros do Formulário 4 desde 2004, com a relação do declarante com o emissor (conselheiro, diretor, detentor de 10%) incorporada.

Duas distinções que os arquivamentos não fazem sozinhos e que, de outro modo, teriam de ser reconstruídas:

• Nem todo código é uma negociação. O Formulário 4 mistura compras e vendas em mercado (P/S) com outorgas (A), exercícios de opções (M/X) e retenção de imposto (F). Somá-los produz um número que parece atividade de negociação e não é: cada linha carrega uma classificação activity, e o endpoint filtra por padrão para mercado aberto.
• Linhas de derivativos são objetos distintos. Somar ações de derivativos e não derivativos conta duas vezes um exercício e a operação que o liquida. securityBucket é explícito e filtrável.

Renda fixa

POST /api/content/fixed-income/v1/search · /reference · /prices — papéis mexicanos, corporativos peruanos e debêntures brasileiras. 2,2 milhões de observações de preço; um universo de títulos é descoberto, não conhecido por ticker, então comece pelo search.

• As durations vêm em anos em toda parte. O Brasil publica em dias úteis, convertidos por 252 — o próprio divisor da curva DI.
• Percentual do par é servido apenas onde a fonte publica (PE, BR). O México tem 114 valores de face distintos, então uma razão derivada do seu cadastro seria uma normalização que ninguém consegue sustentar; parValue vai na linha de referência.
• Nada é convertido de moeda: uma taxa é uma taxa e uma duration é tempo. Cada linha declara a própria moeda.
• Os ratings voltam como um mapa por agência — seis avaliam papel mexicano e discordam entre si.

Taxas de fundos

POST /api/content/funds/v1/fees — taxas de administração e de performance, despesas totais, cargas e giro. Classes americanas a partir das divulgações do prospecto (7,58 milhões de fatos sobre 64.931 classes), fundos brasileiros a partir das suas próprias divulgações regulatórias.

• grossExpenseRatio e netExpenseRatio nunca são reduzidos a um único número: a diferença é uma isenção, e isenções expiram.
• Todos os campos de uma linha vêm de um documento, cuja data está na linha. Ler o valor mais recente de cada campo isoladamente produzia tabelas de taxas que nenhum prospecto chegou a declarar.
• asOf seleciona a divulgação mais recente publicada naquela data ou antes.

Mudanças de participação

POST /api/content/ownership/v1/changes — o que as instituições fizeram num ativo entre dois trimestres: quem entrou, aumentou, reduziu ou saiu, ordenado pelo que de fato se moveu.

• As duas carteiras são montadas pela autoridade de participações institucionais da plataforma: uma emenda NEW HOLDINGS é aditiva, não substitutiva, de modo que uma carteira é o arquivamento base mais todas as emendas aditivas posteriores. Lida como substituição, a carteira de um gestor saiu em US$ 47,0 bi contra US$ 4.042,9 bi reais.
• Ações: NEW · ADDED · TRIMMED · EXITED · NOT_FILED · UNCHANGED, filtráveis.

Execução em lote

Todo endpoint de dados aceita "batch": "Y" com o corpo de requisição idêntico — vire uma única flag quando a pasta de trabalho crescer além dos limites síncronos. O ramo em lote executa o mesmo caminho de código do síncrono, então os resultados são idênticos por construção.

Os jobs pertencem à conta que os enviou e expiram após 24 horas. Jobs com falha entregam um envelope EXECUTION_ERROR pelo mesmo contrato.

Exportação em massa

A execução em lote escala uma planilha. A exportação em massa resolve o problema oposto: carregar um conjunto de dados no seu próprio repositório e mantê-lo atualizado. Um job, um arquivo comprimido e um cursor exato de onde continuar.

# Carga inicial: todo o histórico de preços em um arquivo
curl -b cookies.txt -X POST https://api.edi.finance/api/content/bulk/v1/export \\
  -H "Content-Type: application/json" -d '{"dataset": "prices_eod"}'

# Toda noite: apenas o que foi escrito desde a última carga
curl -b cookies.txt -X POST https://api.edi.finance/api/content/bulk/v1/export \\
  -H "Content-Type: application/json" \\
  -d '{"dataset": "prices_eod", "changedSince": "2026-08-21T23:16:18.915379Z"}'

• Nove conjuntos hoje: prices_eod, corporate_actions, corporate_action_factors, identifier_history, filings_index, insider_transactions, fundamentals_standardized, index_levels, fund_monthly_returns.
• Uma janela de datas e changedSince são alternativas, nunca ambas: uma seleciona um período, a outra o que mudou.
• Conjuntos sem marca de escrita rejeitam changedSince explicitamente, em vez de devolver tudo a cada vez — o que pareceria um feed incremental funcionando.
• As colunas são uma projeção declarada por conjunto: uma coluna adicionada internamente nunca aparece sem aviso no seu repositório. Os arquivos expiram em 48 horas.
• Duas exportações rodam simultaneamente em toda a plataforma; uma terceira recebe 429 com Retry-After.

Situação dos conjuntos de dados

GET /api/analytics/v1/datasets — por conjunto: janela de cobertura, última carga, contagem de linhas e entidades, quais endpoints o servem e um veredicto de atualidade.

• lastObservation é a última data útil presente nos dados; lastLoadedAt é a última escrita. Respondem a perguntas diferentes — um carregador que rodou há uma hora sem escrever nada novo é uma falha distinta de um que não roda há uma semana — por isso são campos separados, e lastLoadedScope diz o que a sonda de escrita mediu.
• freshness é FRESH · LAGGING · STALE · UNKNOWN, avaliado contra um expectedLagBusinessDays próprio de cada conjunto. Um único limiar não serve para um feed diário de preços e para uma declaração trimestral de posições, então a defasagem em dias úteis também é retornada para seu próprio critério.
• rowCountIsEstimated distingue uma estimativa do planejador de uma contagem exata.
• computedAt é a atualização que produziu a linha: um atualizador parado informa a própria idade em vez de passar cobertura antiga por atual.

Conversão de moeda

A conversão é feita no servidor e é sensível à semântica — o tipo certo de taxa de câmbio se aplica a cada valor:

Taxas cruzadas compõem-se via USD. Uma conversão que não pode ser precificada — moeda de origem desconhecida, par não suportado, nenhuma taxa dentro da janela de defasagem — é um erro de linha FX_UNAVAILABLE com as linhas afetadas descartadas: você nunca recebe silenciosamente valores nativos sem conversão.

CSV em toda parte. Envie Accept: text/csv a qualquer endpoint de dados e as linhas planas do envelope voltam como arquivo CSV — mapas aninhados viram colunas com ponto, erros por linha acompanham como comentários # e o registryVersion é carimbado no final. O caminho mais rápido de qualquer endpoint para uma planilha ou dataframe.

Pesquisa — pacote acadêmico

A superfície de pesquisa acadêmica — painéis ponto-no-tempo sobre universos históricos livres de viés de sobrevivência, fixados por Research Snapshots citáveis — está listada no índice de endpoints abaixo em /api/research/…. Mesma autenticação de todos os endpoints; enquanto a seção Academia estiver em fase de testes, os endpoints de pesquisa exigem também o papel de pesquisa na sua conta.

Downloads — o pacote acadêmico

Auto-hospedado e versionado com a plataforma: o wheel do SDK edifinance, os notebooks de ensino em três idiomas (inglês, espanhol, português — pastas de Excel de amostra incluídas), e os doze capítulos de metodologia. O SDK não está no PyPI enquanto a Academia estiver em fase de testes — instale-o direto daqui (funciona também no Colab).

# o SDK ainda não está no PyPI — instale a partir da plataforma
pip install https://api.edi.finance/static/academic/edifinance-0.1.1-py3-none-any.whl

• edi-academic-package.zip — tudo: wheel do SDK, notebooks (en/es/pt), capítulos de metodologia, pastas de Excel.
• edifinance-0.1.1-py3-none-any.whl — apenas o SDK de Python.
• notebooks/README.md — o inventário de notebooks; arquivos individuais em /static/academic/notebooks/.

Índice completo de endpoints

Every operation the service routes, 113 of them, generated from the route table itself. The sections above describe the ones most clients start with; everything here is live and callable.

Taxonomia de erros

Falhas no nível da requisição usam os status HTTP padrão: 400 requisição malformada · 401 não autenticado · 404 id de lote desconhecido/expirado.

Limites de requisição

Clientes & Excel

Python. O cliente de referência (edi_analytics.py) encapsula o login, o envelope e o polling de lotes, e traz os helpers de spill usados pela integração com o Excel — spill_scalar, spill_series, spill_fundamentals, spill_ratios, spill_matrix, spill_fibonacci — cada um retornando uma grade 2-D pronta para um dataframe ou uma matriz dinâmica.

Excel. O suplemento registra fórmulas exatamente sobre esta API. Comece pelo guia de instalação para Excel, que cobre tanto a implantação por um administrador do Microsoft 365 quanto a instalação individual. Também é possível baixar diretamente o manifesto de produção ou a pasta de trabalho de demonstração.

=EDI.VALUE("AAPL-US", "MARKET_CAP")                → um valor
=EDI.HISTORY("BBAS3-BR", "price", "2026-01-01", "2026-07-30", "M")   → spill de 7×2
=EDI.FUNDAMENTALS("AAPL-US", "REVENUE", "LTM")   → spill de períodos fiscais
=EDI.MATRIX(A2:A20, B1:F1)                          → spill de uma grade de comparáveis

Entradas inválidas degradam célula a célula (#N/A, #NAME?) — nunca uma atualização de pasta de trabalho que falha por inteiro. O suplemento agrupa as requisições de fórmula pela execução em lote automaticamente.

Qualquer outra stack. O documento OpenAPI 3 alimenta clientes gerados para outras linguagens.

Experimente

Entre com sua conta EDI e execute requisições ao vivo contra a API — todos os exemplos desta página são executáveis. As requisições rodam com as suas permissões de acesso, exatamente como rodariam a partir do Excel ou de um script.

Recursos em preparação

Estes eixos de requisição fazem parte do contrato, mas são deliberadamente rejeitados (HTTP 400, com mensagem explicativa) até que o maquinário que os sustenta entre em produção — você pode programar contra o vocabulário hoje sem risco de respostas erradas silenciosas:

• basis: "restated" — demonstrações reapresentadas, aguardando modelagem de vintages.
• periodicity: "SEMI" — emissores de reporte semestral, aguardando normalização.
• adjust: "UNSPLIT" / "SPLIT_SPINOFF" — aguardando histórico de fatores de ajuste na rota de serviço. Os fatores em si já estão disponíveis em /corporate-actions e via exportação em massa.
• Estimativas de consenso — não há fonte por trás do dataset. Apenas demonstrações reportadas são servidas.
• Endpoints point-in-time (/point-in-time, /periods) — reservados para backtesting livre de viés de lookahead.
• Domínios de conteúdo de fundos e screener.