1nforma.ai — API de notícias do mercado brasileiro

Notícias e análises do mercado financeiro brasileiro, estruturadas para máquinas. Cada item traz sentimento, tickers, tópicos, scores de impacto/urgência e clustering de histórias (story_id).

Base URL: https://api.1nforma.ai Documentação para IAs: https://api.1nforma.ai/llms.txt

Autenticação

Toda requisição exige uma chave de API (formato 1nf_...). Envie por um destes meios:

Header Authorization: Bearer 1nf_SUA_CHAVE (preferido)
Header X-API-Key: 1nf_SUA_CHAVE
Feeds apenas: query param ?key=1nf_SUA_CHAVE (para leitores RSS sem suporte a headers)

Erros de autenticação/limite:

401 {"error":"missing_api_key"} — chave ausente
401 {"error":"invalid_key"} — chave inválida ou revogada
429 {"error":"rate_limited"} — excedeu requisições por minuto
429 {"error":"quota_exceeded"} — excedeu a cota diária
503 {"error":"auth_unavailable"} — falha transitória; tente novamente

Cada endpoint tem um custo em unidades de cota: busca/stats/related/MCP = 2, item único = 1, feeds = 1.

GET /v1/news — busca

Parâmetros (todos opcionais):

q — busca textual no título
ticker — filtra por ticker (ex.: PETR4, VALE3; case-insensitive)
source — filtra por fonte (ver /v1/sources)
sentiment — positive | negative | neutral
from, to — janela de publicação (ISO 8601, ex.: 2026-06-01T00:00:00Z)
min_impact — score mínimo de impacto (0-1)
min_relevance — relevância mínima (0-1)
size — itens por página, padrão 20, máximo 100 (atenção: o parâmetro é size, não limit)
cursor — paginação (ver abaixo)

Exemplo:

curl -s "https://api.1nforma.ai/v1/news?ticker=PETR4&size=10" \
  -H "Authorization: Bearer 1nf_SUA_CHAVE"

Resposta:

{
  "items": [
    {
      "id": "abc123",
      "source": "narrativa",
      "headline": "…",
      "body": "markdown completo ou null",
      "published_at": "2026-06-10T12:00:00+00:00",
      "language": "pt-BR",
      "tickers": ["PETR4"],
      "topics": ["petroleo"],
      "sentiment": "positive",
      "sentiment_score": 0.82,
      "impact_score": 0.6,
      "urgency_score": 0.3,
      "summary": "resumo curto ou null",
      "story_id": "cluster-id ou null",
      "publisher": "1nforma.ai",
      "license": "1nforma-partner-v1"
    }
  ],
  "next_cursor": "2026-06-09T18:30:00+00:00"
}

Paginação: passe next_cursor da resposta anterior como cursor na próxima chamada. O cursor é inclusivo no timestamp — itens publicados no mesmo segundo do corte podem repetir; deduplique por id.

GET /v1/news/{id} — item único

Retorna o item ou 404 {"error":"not_found"} (ids inexistentes e itens fora do seu escopo respondem o mesmo 404).

size — máximo 20, padrão 5

Relaciona pela mesma história (story_id) ou, na ausência, por tickers em comum.

GET /v1/stats/sentiment — distribuição de sentimento

hours — janela em horas, padrão 168 (7 dias), máximo 720

{ "window_hours": 168, "counts": { "positive": 41, "negative": 17, "neutral": 92 }, "sample": 150 }

field — source | topics | tickers (padrão source)
hours — padrão 168, máximo 720

Retorna os top 50: { "facets": { "PETR4": 12, "VALE3": 9 }, ... }

GET /v1/stats/timeline — volume no tempo

bucket — hour | day (padrão day)
hours — padrão 168, máximo 720

hours — padrão 24, máximo 720

GET /v1/sources — fontes disponíveis

Lista as fontes visíveis para a SUA chave: { "sources": ["narrativa", "premarket-us"] }

Feeds — RSS 2.0 e JSON Feed 1.1

https://api.1nforma.ai/feeds/{source}.rss?key=1nf_SUA_CHAVE
https://api.1nforma.ai/feeds/{source}.json?key=1nf_SUA_CHAVE

Parâmetros extras: ticker (filtro) e limit (padrão 50, máximo 100 — nos feeds o nome é limit mesmo).

MCP — para agentes de IA (Claude, Cursor, etc.)

Servidor MCP remoto (streamable HTTP) com autenticação Bearer:

URL: https://api.1nforma.ai/mcp/mcp

Claude Code:

claude mcp add --transport http 1nforma https://api.1nforma.ai/mcp/mcp \
  --header "Authorization: Bearer 1nf_SUA_CHAVE"

Cursor / Claude Desktop (mcp.json):

{
  "mcpServers": {
    "1nforma": {
      "url": "https://api.1nforma.ai/mcp/mcp",
      "headers": { "Authorization": "Bearer 1nf_SUA_CHAVE" }
    }
  }
}

Tools disponíveis:

news_search — busca com filtros (q, ticker, source, sentiment, min_impact)
news_get — item por id
news_related — relacionados a um id
news_trending — tickers mais citados na janela
news_stats — distribuição de sentimento
news_sources — fontes visíveis para a chave

Boas práticas

Pagine com cursor e deduplique por id.
Cache de 60s é suficiente para a maioria dos casos; o conteúdo é atualizado continuamente.
Trate 429 com backoff (espere até o próximo minuto/dia conforme o erro).
O campo body é Markdown — renderize ou converta conforme seu meio.
Atribuição: republique citando "1nforma.ai" (licença 1nforma-partner-v1).

Acesso

Chaves de API para veículos de notícias, desenvolvedores e agentes de IA — sob consulta. Healthcheck público: https://api.1nforma.ai/healthz