API 文档

alphasmo 公开 REST API —— 按 IP 提供免登录的免费额度，使用 API 密钥可提升限额。

快速开始

免注册即可使用，额度较低。

curl https://alphasmo.com/api/v1/institutions

获取免费 API 密钥以提升使用额度。

curl -H "X-API-Key: <your-key>" https://alphasmo.com/api/v1/institutions

get/api/v1/health

Health

get/api/v1/institutions

List Institutions

参数	位置	必填
q	query	—
limit	query	—
offset	query	—

get/api/v1/institutions/{slug}

Get Institution

参数	位置	必填
slug	path	✓

get/api/v1/institutions/{slug}/holdings

Get Institution Holdings

参数	位置	必填
slug	path	✓

get/api/v1/market/stock/{identifier}

Get Stock Detail

参数	位置	必填
identifier	path	✓

get/api/v1/market/stock-flows

Get Stock Flows

参数	位置	必填
direction	query	—
limit	query	—

get/api/v1/insider/stock/{ticker}

Get Insider Stock Detail

参数	位置	必填
ticker	path	✓

get/api/v1/insider/smart-money-convergence

Get Smart Money Convergence

参数	位置	必填
limit	query	—
min_confidence	query	—
days	query	—

get/api/v1/insights/13f/{slug}

Get Insight Article

参数	位置	必填
slug	path	✓
locale	query	—

get/api/v1/insights/13f/by-institution/{institution_slug}

Get Institution Insights

参数	位置	必填
institution_slug	path	✓
locale	query	—

get/api/v1/insights/13f

List Insight Articles

参数	位置	必填
limit	query	—
offset	query	—
locale	query	—

CLI 命令

alphasmo npm 包自带的命令行工具——免注册、免 API 密钥即可试用。

npx alphasmo stocks get AAPL

命令	说明
alphasmo institutions search <query>	按名称搜索 13F 机构。
alphasmo institutions get <slug>	完整机构档案与行业权重。
alphasmo institutions holdings <slug>	机构目前的 13F 持仓。
alphasmo stocks get <identifier>	完整个股数据——持有机构数、资金流向、主要持有者。
alphasmo stocks flows [-d buy\|sell]	按机构净买卖流向排序的个股。
alphasmo insider trades <ticker>	个股近期的 Form 4 内部人交易记录。
alphasmo insider summary <ticker>	个股的内部人信心分数（30天/90天）。
alphasmo convergence	机构与内部人同步买进的个股。

MCP 服务器

供 AI 代理程序使用（Claude Code、Claude Desktop、Cursor 等），不是给人直接输入的——直接输入请用上方的 CLI。以可调用工具的形式提供同一份数据。

npx -y alphasmo@latest mcp

将以下配置添加到你的 MCP 客户端服务器配置中：

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": ["-y", "alphasmo@latest", "mcp"]
    }
  }
}

工具	说明
search_institutions	按名称搜索机构投资者。
get_institution_profile	获取机构的档案——类别、经理人、资产规模、投资风格分数。
get_institution_holdings	获取机构目前的 13F 持仓。
get_stock_overview	获取个股的机构持有概况——持有机构数、净流向、热门度排名。
get_stock_flows	获取按机构净流向排序的买超或卖超个股。
get_insider_activity	获取个股的 Form 4 内部人交易活动。
get_smart_money_convergence	获取机构与内部人同步买进的个股。