Equibles: Dados do Mercado de Ações dos EUA

Visão Geral

Equibles fornece dados sobre empresas listadas nos EUA a partir de arquivos da SEC, comunicados da empresa e teleconferências de resultados: pesquisa de texto completo em 10-K, 10-Q, 8-K e outros arquivos, demonstrações financeiras XBRL, transcrições de teleconferências de resultados, transações de insiders do Formulário 4, participações institucionais 13F, negociações do congresso, juros em descoberto e preços de fim de dia. Os resultados da pesquisa e as linhas das demonstrações carregam a data do arquivo e o documento de onde vieram, para que as respostas possam citar sua origem.

Os mesmos dados estão disponíveis através de um servidor MCP hospedado e uma API REST JSON. Esta habilidade cobre ambos: quando usar cada um, o fluxo de trabalho de pesquisa e leitura de arquivos, demonstrações, dados de insiders e 13F, transcrições e os limites do plano.

Quando Usar

• Use quando o usuário perguntar o que o 10-K, 10-Q ou 8-K de uma empresa diz sobre um tópico e quiser a passagem citada.
• Use quando o usuário quiser uma demonstração de resultados, balanço patrimonial ou demonstração de fluxo de caixa para um ano fiscal ou trimestre.
• Use quando o usuário perguntar quem comprou ou vendeu ações: insiders da empresa (Formulários 4 e 5), detentores institucionais 13F ou membros do Congresso.
• Use quando o usuário quiser uma transcrição de teleconferência de resultados ou histórico de preços diários de uma ação listada nos EUA.
• Não use para execução de ordens, cripto ou séries macro não americanas. Equibles nunca executa negociações.

Acesso e Autenticação

Servidor MCP (preferível quando o cliente o suporta)

• Endpoint: https://mcp.equibles.com/mcp (HTTP Streamable), listado no registro oficial do MCP como io.github.daniel3303/equibles.
• ChatGPT e Claude se conectam via OAuth sem chave de API. No Claude Code: claude mcp add --transport http equibles https://mcp.equibles.com/mcp, então execute /mcp e escolha Autenticar.
• Se o cliente já o conectou, prefira suas ferramentas (SearchDocuments, GetFinancialStatement, GetInsiderTransactions, GetTopHolders, GetEarningsCallTranscript) em vez de chamadas HTTP brutas.
• A maioria das ferramentas apenas lê dados. Ferramentas de portfólio, lista de observação e feedback escrevem na conta Equibles do próprio usuário; chame-as apenas quando o usuário pedir.

API REST

• URL base: https://api.equibles.com/v1. Especificação OpenAPI: https://api.equibles.com/openapi/v1.json.
• Cada solicitação precisa de uma chave de API (começa com eq_). Leia-a da variável de ambiente EQUIBLES_API_KEY e envie-a como Authorization: Bearer $EQUIBLES_API_KEY. Nunca coloque a chave na URL ou a imprima.
• Uma solicitação sem chave retorna HTTP 401 com "code": "unauthorized". Isso significa que uma chave é necessária, não que os dados estão faltando.
• As respostas são JSON com campos em camelCase e datas yyyy-MM-dd. Endpoints paginados retornam data mais meta (limit, offset, count, hasMore).
• Erros compartilham uma forma: {"error": {"code", "message", "status"}}.

Planos

• O plano gratuito permite 100 solicitações por dia, compartilhadas entre chamadas de ferramentas MCP e solicitações REST, e reinicia às 00:00 UTC. Sem cartão de crédito.
• Gratuito cobre preços de fim de dia. Cadeias de opções e cotações intraday exigem um plano Plus ou Pro.
• Respostas REST com status de 400 a 599 não contam para a cota diária.

Como Funciona

Passo 1: Pesquisar arquivos sobre o tópico

curl -s -H "Authorization: Bearer $EQUIBLES_API_KEY" \
  "https://api.equibles.com/v1/stocks/AAPL/filings/search?query=tariffs&documentType=TenK&limit=3" \
  | jq '.data[] | {documentId, documentTypeName, filedDate, startLineNumber, url, text}'

Use /v1/filings/search?query=... (sem ticker no caminho) para pesquisar todas as empresas. Cada trecho carrega um documentId e a linha onde ele começa.

Passo 2: Ler as linhas circundantes

curl -s -H "Authorization: Bearer $EQUIBLES_API_KEY" \
  "https://api.equibles.com/v1/filings/$DOCUMENT_ID/lines?startLine=698&endLine=764" \
  | jq -r '.lines[] | "\(.number): \(.text)"'

Comece no startLineNumber do trecho (o fator de risco de tarifa da Apple estava na linha 698 de seu 10-K de 2025) e leia no máximo 500 linhas por solicitação. Cite essas linhas e o tipo de arquivo e filedDate.

Passo 3: Puxar os números

curl -s -H "Authorization: Bearer $EQUIBLES_API_KEY" \
  "https://api.equibles.com/v1/stocks/MSFT/financial-statements/income?year=2025&period=FY" \
  | jq '{companyName, fiscalYear, fiscalPeriod, rows: [.data[] | {lineItem, value, unit, periodStart, periodEnd, form, filedDate}]}'

…