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 分