AlphaSMO

CLI + servidor MCP para participações institucionais SEC 13F, negociação com informações privilegiadas e sinais de convergência de dinheiro inteligente. Camada anônima gratuita, sem necessidade de cadastro.

GitHub

Experimente este MCPPatrocinado

Documentação

AlphaSMO — A API Definitiva de Smart Money para IA

CLI + servidor MCP para AlphaSMO — participações institucionais SEC EDGAR 13F, negociações de insiders Form 4 e sinais de "convergência de smart money" (tickers onde fundos de hedge e insiders da empresa estão comprando ao mesmo tempo), consultáveis a partir do seu terminal, seus scripts ou qualquer agente de IA compatível com MCP (Claude, ChatGPT, Cursor, etc.).

Sem cadastro, sem chave de API, sem configuração — experimente agora:

npx alphasmo stocks flows --limit 10

Exemplo de saída:

┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐
│ ticker │ issuer                       │ net flow (USD)     │ avg weight % │ institutions │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ BRK-A  │ BERKSHIRE HATHAWAY INC-CL A  │ 247,455,256,379    │ 1.42         │ 1418         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AZN    │ AstraZeneca PLC              │ 148,465,847,587.12 │ 0.47         │ 1309         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ XOM    │ EXXON MOBIL CORP             │ 138,784,059,363.77 │ 0.78         │ 4716         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CVX    │ CHEVRON CORP                 │ 77,783,933,645.44  │ 0.6          │ 4261         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ JNJ    │ JOHNSON & JOHNSON            │ 64,498,075,844.9   │ 0.76         │ 4603         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ SNDK   │ SANDISK CORP                 │ 58,662,972,096.01  │ 0.65         │ 1172         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ MU     │ MICRON TECHNOLOGY INC        │ 55,374,569,969.23  │ 0.7          │ 2993         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AMAT   │ APPLIED MATERIALS INC        │ 48,790,109,328.41  │ 0.52         │ 2931         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ EEM    │ ISHARES MSCI EMERGING MARKET │ 48,211,222,155.7   │ 0.59         │ 1637         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CAT    │ CATERPILLAR INC              │ 46,035,710,179.58  │ 0.5          │ 3724         │
└────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘

Por que AlphaSMO

📊 Participações institucionais 13F — os registros trimestrais na SEC de todos os fundos de hedge e gestoras de ativos: AUM, posições e "pontuações de personalidade" comportamentais (concentração, rotatividade, convicção setorial). Leia nosso guia sobre O que é um Arquivo 13F? e Como Ler Alterações em Participações Institucionais.
🕵️ Negociações de insiders (Form 4 e 144) — compras e vendas de diretores, executivos e acionistas com 10% ou mais, com uma pontuação de confiança por ticker. Saiba mais em O que é um Arquivo Form 4? e O que é um Arquivo Form 144?.
🚀 Convergência de smart money — o sinal principal: tickers onde instituições 13F e insiders da empresa estão ambos comprando agora.
🤖 Feito para agentes de IA — um servidor MCP pronto para uso, para que Claude, ChatGPT, Cursor ou qualquer cliente MCP possa obter dados financeiros reais durante a conversa.
🆓 Camada anônima gratuita — sem cadastro para experimentar; obtenha uma chave de API gratuita a qualquer momento para aumentar seu limite de requisições.

Casos de uso

"What is smart money buying right now?"        → alphasmo convergence
"What does Berkshire Hathaway hold?"            → alphasmo institutions holdings berkshire-hathaway-inc
"Are insiders buying or selling NVDA?"          → alphasmo insider summary NVDA
"Which stocks are institutions dumping?"        → alphasmo stocks flows --direction sell

Conecte o servidor MCP ao Claude Desktop, Claude Code, Cursor ou qualquer cliente MCP (veja abaixo) e faça perguntas em linguagem natural — sem necessidade de código.

CLI

npx alphasmo institutions search "Berkshire"
npx alphasmo stocks get AAPL
npx alphasmo convergence -l 5

Sem etapa de instalação — o npx baixa e executa. Ou instale globalmente:

npm install -g alphasmo
alphasmo --help

Comandos

Comando	O que retorna
`alphasmo institutions search <query> [-l\|--limit]`	Buscar instituições 13F por nome
`alphasmo institutions list [-l\|--limit] [-o\|--offset]`	Paginar todo o universo de instituições (sem consulta)
`alphasmo institutions get <slug>`	Detalhes completos da instituição, pesos setoriais
`alphasmo institutions holdings <slug>`	Participações 13F mais recentes de uma instituição
`alphasmo stocks get <identifier>`	Detalhes completos da ação — nº de detentores, fluxos, principais detentores (identificador = ticker ou CUSIP)
`alphasmo stocks flows [-d\|--direction buy\|sell] [-l\|--limit]`	Ações classificadas por fluxo líquido institucional de compra/venda
`alphasmo insider trades <ticker>`	Negociações individuais recentes de insiders Form 4 para um ticker
`alphasmo insider summary <ticker>`	Pontuações de confiança de insiders (30d/90d) para um ticker
`alphasmo convergence [-l\|--limit] [--min-confidence] [--days]`	Tickers onde instituições 13F e insiders estão ambos comprando — o sinal principal
`alphasmo mcp`	Iniciar o servidor MCP via stdio

Flags globais em todos os comandos: --api-key <key> (env ALPHASMO_API_KEY), --base-url <url> (env ALPHASMO_BASE_URL), -f/--format json|compact|table|csv, --json (abreviação para --format json), --csv (abreviação para --format csv).

O formato de saída detecta automaticamente seu contexto — sem necessidade de flag no caso comum:

Digitado diretamente no terminal → uma tabela legível, com números formatados com vírgula (263,095,703,570).
Direcionado via pipe, redirecionado ou gerado por script/agente de IA (stdout não é um TTY) → JSON, seguro para usar com jq ou alimentar um agente.
--format/--json/--csv sempre substituem a detecção automática em ambos os casos.

alphasmo stocks flows --csv > flows.csv
alphasmo insider trades AAPL --csv | column -s, -t

Erros vão para stderr com um código de saída distinto (2 não encontrado, 3 autenticação, 4 limite de requisições, 5 formato de resposta inesperado, 1 outros), para que scripts possam ramificar sem fazer correspondência de strings.

Obtenha uma chave de API

Requisições anônimas são limitadas por IP. Cadastre-se e crie uma chave gratuita em alphasmo.com/developer, depois:

alphasmo convergence --api-key ask_live_...
# or
export ALPHASMO_API_KEY=ask_live_...

Servidor MCP

Opção 1: `claude mcp add` (recomendado)

Se você usa Claude Code, registre o servidor com um único comando:

claude mcp add alphasmo -- npx -y alphasmo@latest mcp

Adicione -e ALPHASMO_API_KEY=ask_live_... antes do -- para aumentar seu limite de requisições. Execute claude mcp list para confirmar que está conectado.

Opção 2: configuração manual do cliente MCP

Para Claude Desktop, Cursor ou qualquer outro cliente MCP, adicione isto ao seu arquivo de configuração diretamente:

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": ["alphasmo", "mcp"],
      "env": { "ALPHASMO_API_KEY": "optional-your-key-here" }
    }
  }
}

Ambas as opções funcionam anonimamente de imediato, com limites de requisições menores do que com uma chave. Ferramentas expostas: search_institutions, get_institution_profile, get_institution_holdings, get_stock_overview, get_stock_flows, get_insider_activity, get_smart_money_convergence.

Referência completa de endpoints: alphasmo.com/developer/docs.

Uso programático

import { AlphasmoClient } from "alphasmo";

const client = new AlphasmoClient(); // no apiKey needed to try it
console.log(await client.getSmartMoneyConvergence({ limit: 5 }));

npm install alphasmo

Um cliente Python + servidor MCP também está disponível — veja alphasmo.com/developer para configuração.

Saiba mais

alphasmo.com — o aplicativo web completo: perfis de instituições, seletores de ações, rankings de negociações de insiders
alphasmo.com/developer — obtenha uma chave de API gratuita
alphasmo.com/developer/docs — referência completa da API pública

Guias Educacionais e Análises Aprofundadas de Arquivos SEC

Aprofunde seu entendimento sobre participações institucionais e dinâmicas de arquivos SEC:

O que é um Arquivo 13F? — Guia para iniciantes sobre divulgações de participações institucionais.
O que é um Arquivo Form 4? — Como as compras e vendas de insiders são reportadas.
O que é um Arquivo Form 144? — Entendendo os avisos prévios de venda na SEC antes de vendas de insiders.
13D vs. 13G: Propriedade Beneficiária — Descobrindo arquivos de propriedade de 5% e a intenção de investidores ativistas.
Como Ler Alterações em Participações Institucionais — Navegando por mudanças em carteiras 13F sem ser enganado por desdobramentos de ações ou mecânicas de opções.

Licença

MIT