XOOMAR market data

com.xoomar由 xoomar.com 发布官方发布者v0.1.11更新于 Oct 24, 2026

Free US market data as tools: SEC filings, insiders, short interest, 13F, COT, Fed liquidity.

已验证Streamable HTTP可网页运行网页搜索与抓取金融数据与分析

概览

AI 生成的概览

XOOMAR 市场数据为助手提供 26 个工具,覆盖免费的美国市场数据:SEC 文件、内部人交易、做空数据、13F 持仓、COT、美联储流动性和加密市场。

可以做什么
查询美股做空兴趣、每日做空成交量、交割失败和 Reg SHO 门槛名单,以及 Form 4 和 Form 144 的内部人交易、内部人集中买入和计划减持,还有 13D 和 13G 的大额持有人。查看 13F 基金持有人和被跟踪机构的最新组合、XBRL 公司财务、8-K 公司事件、财报日期、Form D 私募、IPO 申报和上市公司的比特币持仓。读取宏观与市场数据:CFTC 持仓、永续合约资金费率、美联储净流动性和 FRED 系列、38 个经济体的央行政策利率、收益率曲线和稳定币供应、国债拍卖和美国经济日历。查看加密市场数据,并查阅底层 API 的端点、参数和速率限制说明。
适用场景
当你希望助手基于一手来源回答美国股票、申报文件和宏观状况的问题时使用,例如做空兴趣走势、内部人买入、基金持仓、美联储流动性或国债拍卖,而无需自建数据管道。
运行要求
可作为托管的 Streamable HTTP 端点使用,也可通过 npx 以 stdio 在本地运行,需要 Node.js。无需密钥即可开始;可选的免费账户密钥放在 XOOMAR_API_KEY,或通过 Authorization 或 X-API-Key 请求头发送,可将限制从每分钟 10 次提高到 30 次。无密钥和免费密钥请求最多返回六个月历史。XOOMAR_MAX_ROWS 设置每次结果行数(默认 200)。
安装前请注意
无密钥时每个 IP 每分钟限 10 次请求,历史数据最多六个月。转载数据需以可见链接署名 XOOMAR,并附上结果的 sourceAttribution 行;数据的使用范围由条款规定,Apache-2.0 许可仅覆盖代码而非数据。工具本身是只读查询,但数据来自第三方来源,可能延迟或不完整。

安装

在 SourceWeft 中

  1. 打开 控制台中的 XOOMAR market data,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.xoomar%2Fxoomar-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "xoomar-market-data": {
      "type": "http",
      "url": "https://xoomar.com/mcp"
    }
  }
}

README

xoomar-mcp

[Listed on mcpservers.org]

An MCP server that gives AI agents the XOOMAR free market data API as tools: 26 tools over 31 datasets built from primary sources (SEC EDGAR and XBRL, FINRA, CFTC, the Federal Reserve, USAspending, exchange APIs). No key needed to start.

Use it

Hosted, nothing to install: https://xoomar.com/mcp (Streamable HTTP). Add it as a remote MCP server or custom connector in Claude.ai, Claude Code (claude mcp add --transport http xoomar https://xoomar.com/mcp), ChatGPT, Cursor or any client that connects by URL. Send Authorization: Bearer <key> or X-API-Key with a free account key for 30 requests a minute; without one the limit is 10 a minute per IP. Keyless and free-key requests return up to six months of history.

Local, over stdio: Claude Desktop (claude_desktop_config.json), Claude Code, Cursor, Windsurf and any other MCP client that launches stdio servers:

json
{  "mcpServers": {    "xoomar": {      "command": "npx",      "args": ["-y", "xoomar-mcp"]    }  }}

Claude Code, one line:

bash
claude mcp add xoomar -- npx -y xoomar-mcp

As a library (the hosted endpoint is built this way):

ts
import { buildServer } from "xoomar-mcp";const server = buildServer({ apiKey: "xm_live_...", maxRows: 100 }); // an McpServer with the 26 tools; connect any transport

Optional environment for the stdio bin: XOOMAR_API_KEY (a free account key from https://xoomar.com/signup raises the limit from 10 to 30 requests a minute; keyless and free-key requests return up to six months of history), XOOMAR_MAX_ROWS (rows per tool result, default 200).

Tools

ToolWhat it returns
short_interestFINRA short interest with days to cover, per settlement date
short_volumeFINRA daily short sale volume and the short share of volume, since 2021
fails_to_deliverSEC fails to deliver by settlement date, since 2010
insider_tradesSEC Form 4 insider transactions
insider_clustersCompanies where several insiders bought on the open market in a window
threshold_listReg SHO threshold securities lists (Nasdaq and Cboe, since 2022)
planned_insider_salesSEC Form 144 notices of proposed sale
large_holdersSchedule 13D and 13G holders above 5%
fund_holdersWhich tracked 13F managers hold a ticker
fund_portfolioOne tracked manager's latest 13F portfolio
company_financialsQuarterly and annual figures and the balance sheet from XBRL
earnings_calendarReported earnings dates from 8-K Item 2.02 filings and the next expected date per company (estimated, with its basis)
corporate_events8-K material events by item
cot_positioningCFTC Commitments of Traders, latest or one market's history
funding_ratesPerpetual funding on Binance, Bybit, OKX, Hyperliquid and Kraken (BitMEX history to 16 Sep 2026, when it closed its swaps)
fed_liquidityNet liquidity and its components, or one FRED series
policy_ratesCentral bank policy rates, 38 economies with a current series
macro_seriesUS yield curve, spreads, stablecoin supply
treasury_auctionsTreasury auction results and calendar since 2010
economic_calendar22 US release types from the agencies' schedules, with actuals after release
private_placementsSEC Form D private placements
ipo_pipelineS-1, F-1, 424B4, EFFECT and RW filings
bitcoin_treasuriesBitcoin held by public companies
federal_contractsUS federal contract actions by listed parent
crypto_marketOpen interest, liquidations, options metrics, whale positions
api_referenceHow the underlying API works

Every result carries updatedAt, source (who publishes the data: FINRA, the SEC, the CFTC, the exchange), sourceAttribution (the credit line to show with it) and the attribution line. Ask things like "How has GME short interest moved this year?", "Which tracked funds bought NVDA last quarter?", "What is Fed net liquidity doing?", "Show open-market insider purchases in the last 7 days".

Where it is listed

Listed in the official MCP registry as com.xoomar/xoomar-mcp, on npm as xoomar-mcp, and on mcpservers.org.

Data terms

When you republish the data, credit XOOMAR with a visible link to the dataset page on xoomar.com, together with the result's sourceAttribution line. What you may do with the data is set out at https://xoomar.com/terms.

Development

bash
npm installnpm test        # builds, then talks to the server over stdio (one test hits the live API)

Apache-2.0 for this code, XOOMAR. The license covers the code only, not the data.

来源:README.md,提交 9925724

工具

26

short_interest

FINRA short interest

Short interest for a US stock: shares short, average daily volume, days to cover, change, per FINRA settlement date (twice a month), newest first. Without a symbol: the latest settlement's highest days-to-cover names.

输入参数limitsymbol

short_volume

FINRA daily short sale volume

Daily short sale volume and total volume per symbol from FINRA's Reg SHO files since August 2021, with the short share of volume. History for a symbol (oldest first; from, to and limit select the window, up to 5,000 days) or the latest day's largest short volumes.

输入参数todaysfromsymbol

fails_to_deliver

SEC fails to deliver

SEC fails-to-deliver quantity and price by settlement date for a symbol since January 2010 (from, to and limit select the window, up to 5,000 dates), or the latest settlement's largest fails by value.

输入参数tofromlimitsymbol

insider_trades

SEC Form 4 insider trades

Insider transactions from SEC Form 4: insider name and title, transaction code, shares, price, value, date. History for a ticker (from, to and limit select the window, up to 2,000 rows) or the latest trades across companies (type buys for open-market purchases, sells for sales).

输入参数tofromtypelimittickerwindow

insider_clusters

Insider cluster buying

Companies where several different insiders bought their own stock on the open market within a window (Form 4 transaction code P only): distinct buyers with titles, trades, combined value, first and latest trade dates. Default: three or more insiders in 30 days, sorted by number of insiders then value. Use ticker to check one company.

输入参数dayslimitminUsdtickerminInsiders

threshold_list

Regulation SHO threshold securities

Reg SHO threshold lists from the Nasdaq and Cboe daily files since 2022: securities whose fails to deliver stayed above the threshold for five settlement days. One date (default the newest), one symbol's days on the list, or one listing market.

输入参数datelimitmarketsymbol

planned_insider_sales

SEC Form 144 notices of proposed sale

Form 144 notices: an affiliate's planned sale of restricted or control stock (seller, shares, approximate market value, planned date), filed before the trade.

输入参数dayssymbol

large_holders

Schedule 13D and 13G holders

Holders above 5% from Schedule 13D (active) and 13G (passive) cover pages: holder, shares, percent of class, filing date. For a symbol or the latest filings.

输入参数daysformsortsymbol

fund_holders

13F institutional holders of a stock

Which tracked 13F managers (Berkshire, Bridgewater, Citadel, Renaissance and others) held a ticker at their latest quarterly filing: shares, value, share of portfolio, change.

输入参数ticker必填

fund_portfolio

A tracked manager's 13F portfolio

The latest 13F portfolio of one tracked manager by slug, e.g. berkshire-hathaway, bridgewater, citadel-advisors, renaissance-technologies. Positions with value, shares and share of portfolio.

输入参数slug必填

company_financials

Company financials from SEC XBRL

Quarterly revenue, net income and diluted EPS (calendar quarters, fourth quarter derived from the annual report), annual revenue, net income, operating cash flow, capex, buybacks and dividends, and the latest balance sheet instants, from the company's own XBRL filings.

输入参数symbol必填

corporate_events

SEC 8-K material events

8-K current reports with their item numbers (2.02 earnings, 5.02 officer changes, 1.01 agreements and so on), for a ticker or the latest across companies.

输入参数daysitemticker

earnings_calendar

Earnings calendar (8-K Item 2.02)

When US companies report results, from their own 8-K filings. With a ticker: every reported date since 2023 and the next expected date (an estimate until the company confirms it). Without: the calendar window (default today to 14 days ahead; from and to open any window up to 120 days; status reported or estimated). Dates only, no EPS or consensus.

输入参数tofromlimitstatusticker

cot_positioning

CFTC Commitments of Traders

Weekly CFTC positioning: the latest report across all tracked markets, or one market's history by slug (e.g. gold, bitcoin, euro-fx, e-mini-s-p-500-stock-index, 10-year-u-s-treasury-notes-chicago-board-of-trade; the latest report lists every slug): open interest and long/short by trader category.

输入参数limitmarket

funding_rates

Perpetual futures funding rates

Current perpetual funding rates on Binance, Bybit, OKX, Hyperliquid and Kraken for tracked crypto symbols (hourly venues shown as the 8-hour equivalent), or one symbol's history by slug (e.g. btc, eth, sol).

输入参数slug

fed_liquidity

Fed liquidity

Weekly US net liquidity (Fed balance sheet minus the Treasury General Account minus reverse repo) with its components, oldest first, or one FRED series (WALCL, WRESBAL, RRPONTSYD, WTREGEN, SOFR, EFFR, IORB, WSHOSHO).

输入参数limitseries

policy_rates

Central bank policy rates

Central bank policy rates for 38 economies with a current series: the current table, or one country code's history (e.g. us, xm for the euro area, jp, gb).

输入参数country

macro_series

US macro series

US Treasury yield curve points, curve spreads and stablecoin supply as daily series. Filter by series name and date range.

输入参数tofromseries

treasury_auctions

US Treasury auctions

Treasury auction results and calendar since 2010 from TreasuryDirect: security type and term, auction and issue dates, offering amount, high yield or discount rate, bid-to-cover, dealer, direct and indirect allotments. Default: coupon auctions (notes, bonds, TIPS, FRNs); upcoming=true lists announced auctions not yet run.

输入参数tofromtermtypelimitupcoming

economic_calendar

US economic calendar

Scheduled US releases from the agencies' own calendars (CPI, PPI, payrolls, weekly jobless claims, PCE, GDP, retail sales, housing, durable goods, industrial production, trade, FOMC decisions and minutes, Beige Book), with the actual and previous print filled after release and a unit field. No consensus figures. Default window: last 7 days to next 30.

输入参数tofromimportance

private_placements

SEC Form D private placements

Form D notices of exempt offerings: issuer, amount sold, amount offered, investors, whether it is a pooled fund. Largest raises in a window, one issuer by CIK, or the most recent filings.

输入参数cikdayssortfunds

ipo_pipeline

IPO pipeline

S-1 and F-1 registration statements, 424B4 final prospectuses, EFFECT notices and RW withdrawals from EDGAR, with the filer's listing status.

输入参数newdaysform

bitcoin_treasuries

Bitcoin held by public companies

Bitcoin holdings of public companies from their own XBRL filings: coins, fair value, cost basis, as of the filing period.

无需输入参数。

federal_contracts

US federal contract actions

Largest US federal contract actions from USAspending, optionally summed by listed parent company (by=ticker) or filtered to one ticker.

输入参数bydayslistedticker

crypto_market

Crypto market data

Open interest history for a symbol slug, recent liquidations across exchanges, Deribit options metrics (put/call, max pain, DVOL) for BTC or ETH, or Hyperliquid whale positions.

输入参数slugdataset必填

api_reference

XOOMAR API reference

How the underlying free API works: endpoints, parameters, rate limits, CSV downloads and the attribution terms. Use when a tool here does not cover the exact query.

无需输入参数。

版本历史

3
  1. v0.1.11最新Oct 2, 2026
  2. v0.1.10Sep 24, 2026
  3. v0.1.7Sep 18, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分