# XOOMAR

> Free market data from primary sources: SEC EDGAR and XBRL, FINRA, CFTC, the Federal Reserve, USAspending and exchange APIs. 32 datasets on 25 hub pages, every one with a JSON API and CSV downloads. No key needed to start (30 requests a minute), 120 a minute with a free account key. Credit XOOMAR with a link to the dataset page when you republish the data; terms of use at https://xoomar.com/terms.

Company pages stack every SEC and FINRA series for a US ticker: /markets/stocks/{ticker} (for example /markets/stocks/aapl).

## Data hubs

- [Funding rates](https://xoomar.com/markets/funding-rates): Perpetual futures funding on six venues: Binance, Bybit, OKX, Hyperliquid, Kraken Futures and BitMEX. Live every 60 seconds, settled payments at each venue's interval, history to 2019.
- [Open interest](https://xoomar.com/markets/open-interest): Outstanding perpetual futures contracts per asset on Binance, sampled hourly with the long/short ratio and top-trader positioning.
- [CFTC positioning (COT)](https://xoomar.com/markets/cot): Commitments of Traders for financial futures and commodities, every week since 2010, by trader category.
- [Sentiment](https://xoomar.com/markets/sentiment): A composite sentiment score per asset from scored headlines, crowd positioning and institutional flow, every five minutes.
- [Signals](https://xoomar.com/markets/signals): A rules-based composite signal per asset built from sentiment, funding and positioning, refreshed hourly, for bots and for people.
- [Options and volatility](https://xoomar.com/markets/options): Deribit BTC and ETH options open interest by strike and expiry, max pain, and the DVOL implied volatility index.
- [Whale positions](https://xoomar.com/markets/whales): Open perpetual positions of tracked large Hyperliquid accounts: side, size, entry, leverage and unrealized profit, refreshed every five minutes.
- [Macro](https://xoomar.com/markets/macro): US Treasury yield curve since 1990, stablecoin supply since 2017, the effective fed funds rate, and the headline inflation, jobs and growth prints.
- [Liquidations](https://xoomar.com/markets/liquidations): Forced closes of leveraged crypto positions on OKX, Gate.io and HTX, streamed live and rolled up by the hour.
- [Insider transactions](https://xoomar.com/markets/insiders): SEC Form 4 filings as they land: open-market buys and sells by officers, directors and 10% holders, with size, price and holdings after.
- [Structured products](https://xoomar.com/markets/structured-products): Bank-issued structured notes from SEC 424B2 and FWP filings: issuer, underlyings, note type, coupon, barrier and pricing date.
- [Corporate events (8-K)](https://xoomar.com/markets/events): Material corporate events from SEC 8-K filings, classified by item: results, executive changes, deals, financing and more, as they are filed.
- [Fund holdings (13F)](https://xoomar.com/markets/funds): Quarterly 13F holdings for tracked institutional managers: positions, values, portfolio weight and quarter-over-quarter changes.
- [Short interest](https://xoomar.com/markets/short-interest): FINRA short interest twice a month with days to cover, FINRA daily short sale volume for every US listed stock, and SEC fails to deliver by settlement date.
- [Policy rates](https://xoomar.com/markets/rates): Central bank policy rates for 38 economies from the BIS daily series, with the last change and the full history.
- [Economic calendar](https://xoomar.com/markets/calendar): Every scheduled US release that moves markets, from the agencies' own calendars: CPI, PPI, payrolls, jobless claims, PCE, GDP, retail sales, housing, durable goods, industrial production, trade, FOMC decisions and minutes, with the actual filled after each release.
- [Spot ETF flows](https://xoomar.com/markets/etf-flows): Daily net creations and redemptions for every US spot bitcoin and ether ETF, in dollars, since launch.
- [Company pages](https://xoomar.com/markets/stocks): One page per US listed company with every SEC and FINRA series for that ticker: short interest, daily short volume, fails to deliver and insider trades, with history and downloads.
- [Fed liquidity](https://xoomar.com/markets/fed-liquidity): The Federal Reserve balance sheet, bank reserves, the overnight reverse repo facility and the Treasury General Account, weekly from the H.4.1 with net liquidity derived, plus SOFR, EFFR and IORB daily.
- [Private placements (Form D)](https://xoomar.com/markets/startup-funding): Every Form D filed with the SEC: the private company raises and fund closes that never get a press release, with amount sold, investor count, industry and exemption, from EDGAR every 30 minutes.
- [IPO pipeline](https://xoomar.com/markets/ipos): Registration statements, pricings, effectiveness notices and withdrawals from EDGAR: which companies have filed to go public, which priced, which pulled out, updated every 30 minutes.
- [Bitcoin treasuries](https://xoomar.com/markets/bitcoin-treasuries): Bitcoin held by US listed companies as reported in their own 10-Q and 10-K filings: coins, fair value and cost basis from the SEC's structured data, checked against the price.
- [Federal contracts](https://xoomar.com/markets/federal-contracts): The largest US federal contract actions each day from USAspending, with the recipient mapped to its listed parent, the awarding agency and the amount obligated, daily with a weekly re-read for late reports.
- [Earnings calendar](https://xoomar.com/markets/earnings): When US companies report results, from the filings themselves: every 8-K Item 2.02 date since January 2023 and the next expected date per company, computed from last year's filing and labelled as an estimate.

## API

- [API reference](https://xoomar.com/markets/api): every endpoint, parameter and field; JSON envelope {data, updatedAt, source, docs, license, attribution}; CSV at /api/markets/{dataset}/csv
- GET https://xoomar.com/api/markets/funding-rates: Live funding rates on Binance, Bybit, OKX, Hyperliquid, Kraken Futures and BitMEX, with interval and annualized figures
- GET https://xoomar.com/api/markets/open-interest/{slug}: Hourly OI history since 2021
- GET https://xoomar.com/api/markets/cot: Weekly CFTC institutional positioning, 700+ markets
- GET https://xoomar.com/api/markets/sentiment: AI-scored multi-layer sentiment for 17 assets
- GET https://xoomar.com/api/markets/signals/{slug}: Composite trading signals for bots and EAs
- GET https://xoomar.com/api/markets/options/{currency}: Max pain, DVOL, put/call ratio from Deribit
- GET https://xoomar.com/api/markets/whales: Hyperliquid whale positions and moves
- GET https://xoomar.com/api/markets/macro: Yield curve, spreads, stablecoin supply
- GET https://xoomar.com/api/markets/liquidations: Real-time crypto liquidation stream
- GET https://xoomar.com/api/markets/insiders: SEC Form 4 insider trades, all US tickers
- GET https://xoomar.com/api/markets/funds/{slug}: 13F portfolios of 30 famous funds, 5 years of quarters
- GET https://xoomar.com/api/markets/structured-products: 424B2/FWP structured note issuance, 5 years of filings
- GET https://xoomar.com/api/markets/events: Corporate material events mapped to readable labels
- GET https://xoomar.com/api/markets/etf-flows: Spot BTC/ETH ETF holdings and computed net flows
- GET https://xoomar.com/api/markets/calendar: US releases from the agencies' schedules: CPI, PPI, payrolls, claims, PCE, GDP, retail sales, housing, FOMC, with post-release actuals
- GET https://xoomar.com/api/markets/rates/{country}: Policy rates for 49 economies, history to 1945
- GET https://xoomar.com/api/markets/short-interest: FINRA biweekly short interest with days to cover, every US symbol, 5 years
- GET https://xoomar.com/api/markets/short-volume: FINRA Reg SHO daily short sale volume per symbol with the short share of volume
- GET https://xoomar.com/api/markets/fails-to-deliver: SEC fails-to-deliver quantities by settlement date and symbol
- GET https://xoomar.com/api/markets/planned-sales: Notices of proposed insider sales: seller, shares, market value, sale date
- GET https://xoomar.com/api/markets/large-holders: Schedule 13D and 13G cover pages: holder, stake, percent of class
- GET https://xoomar.com/api/markets/financials?symbol={ticker}: XBRL quarterly income, annual cash flow and balance sheet per ticker
- GET https://xoomar.com/api/markets/buybacks: Largest share repurchases per fiscal year from XBRL filings
- GET https://xoomar.com/api/markets/fed-liquidity: Fed balance sheet, reserves, RRP, TGA, net liquidity, SOFR, EFFR, IORB
- GET https://xoomar.com/api/markets/earnings: Reported earnings dates from 8-K Item 2.02 filings since 2023 and the next expected date per company, labelled as an estimate
- GET https://xoomar.com/api/markets/treasury-auctions: Every Treasury auction since 2010: high yield, bid-to-cover, indirect, direct and dealer takedown, plus the announced calendar
- GET https://xoomar.com/api/markets/threshold-list: Daily Regulation SHO threshold securities from Nasdaq and Cboe; one day or one symbol's history
- GET https://xoomar.com/api/markets/startup-funding: Private placements and fund closes as filed, every 30 minutes
- GET https://xoomar.com/api/markets/ipos: S-1, F-1, 424B4, EFFECT and RW filings with the listing status
- GET https://xoomar.com/api/markets/bitcoin-treasuries: Bitcoin held by public companies from their own XBRL filings
- GET https://xoomar.com/api/markets/federal-contracts: Largest daily USAspending contract actions mapped to listed parents
- GET https://xoomar.com/api/tools/edgar-lookup?q={ticker}: Any company's EDGAR submission history by ticker, CIK or name: filing counts and recent filings

## Tools for developers and agents

- Python: pip install xoomar (https://pypi.org/project/xoomar/)
- JavaScript and TypeScript: npm install xoomar (https://www.npmjs.com/package/xoomar)
- MCP server for AI agents: hosted at https://xoomar.com/mcp (Streamable HTTP, no install) or npx -y xoomar-mcp (https://www.npmjs.com/package/xoomar-mcp)
- [Embeddable charts](https://xoomar.com/markets/fed-liquidity): iframe embeds under /embed/* with an attribution link

## Guides

- [SEC filing types explained](https://xoomar.com/markets/sec-filings): what each EDGAR form is, who files it, when it is due, and a lookup of any company's filings
- [Developers](https://xoomar.com/developers): quickstart, tiers, client libraries
- [OpenAPI 3.1 document](https://xoomar.com/openapi.json): every endpoint, parameter and response field, machine-readable

## Optional

- [Terms of use](https://xoomar.com/terms)
- [About](https://xoomar.com/about)
- [Full version of this file](https://xoomar.com/llms-full.txt)