# XOOMAR

> Free US market data from primary sources, as dated pages and a JSON API that needs no key. Start with the US economic calendar: the release dates and times of CPI, the jobs report, PCE, GDP, FOMC decisions, jobless claims and more, from the agencies' own schedules, with the actual figure after each release. 31 datasets in all, on 24 hub pages. 10 requests a minute per IP without a key and 30 a minute with a free account key, with at least six months of history. Credit the data as "Data: XOOMAR" with a link to the page it came from; terms of use at https://xoomar.com/terms.

## US economic calendar API (start here)

- Endpoint: GET https://xoomar.com/api/markets/calendar
- Parameters: from and to as YYYY-MM-DD (without them: the last 7 days and the next 30), importance as high, med or low
- Each event: source (bls, bea, census, fed, dol or treasury), eventName, importance, scheduledAt (UTC), periodLabel, previous, actual (filled after the release), unit (what actual and previous are in), forecast (always null: no consensus figures)
- CSV: https://xoomar.com/api/markets/calendar/csv
- [Free economic calendar API](https://xoomar.com/economic-calendar-api): the same call in curl, Python, JavaScript and MT5, and the next releases
- [Economic calendar](https://xoomar.com/markets/calendar): this week's releases with times in ET and the latest figures
- [Calendar API reference](https://xoomar.com/markets/api/calendar): every parameter and field
- Release pages with the next date and the history of prints: [CPI](https://xoomar.com/markets/calendar/cpi), [jobs report](https://xoomar.com/markets/calendar/jobs-report), [FOMC](https://xoomar.com/markets/calendar/fomc), [GDP](https://xoomar.com/markets/calendar/gdp), [PPI](https://xoomar.com/markets/calendar/ppi), [jobless claims](https://xoomar.com/markets/calendar/jobless-claims), [retail sales](https://xoomar.com/markets/calendar/retail-sales), [PCE](https://xoomar.com/markets/calendar/pce)

Copy and run, no key needed:

    curl "https://xoomar.com/api/markets/calendar?importance=high"

Python (needs the requests package):

    python3 -c "import requests; [print(e['scheduledAt'], e['eventName'], e['actual']) for e in requests.get('https://xoomar.com/api/markets/calendar?importance=high', timeout=10).json()['data']]"

Every response is {data, updatedAt, source, docs, license, attribution, meta}. meta.sourceAttribution names the agencies behind the figures; show it next to "Data: XOOMAR" wherever you display them.

## Other data hubs

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

- [Funding rates](https://xoomar.com/markets/funding-rates): Perpetual futures funding on five venues: Binance, Bybit, OKX, Hyperliquid and Kraken Futures. Live rates every minute, settled rates at each venue's interval, history back to 2019.
- [Open interest](https://xoomar.com/markets/open-interest): Outstanding perpetual futures per asset on Binance, Bybit and OKX, with hourly Binance history since 2021.
- [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): One reading per asset from -1 to +1, updated every 5 minutes. Higher is more bullish.
- [Composite readings](https://xoomar.com/markets/signals): One composite reading per asset from -1 to +1, updated every 5 minutes.
- [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, updated every five minutes.
- [Macro](https://xoomar.com/markets/macro): US Treasury yield curve since 1990, stablecoin supply since 2017 and the effective fed funds rate. Inflation, jobs and growth releases are on the economic calendar.
- [Liquidations](https://xoomar.com/markets/liquidations): Forced closes of leveraged crypto positions on OKX, Gate.io and HTX, live, with hourly and daily totals.
- [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 with a current series (49 in the archive) from the BIS daily series, with the last change and the full history.
- [Spot ETF flows](https://xoomar.com/markets/etf-flows): Daily net flows and holdings of US spot bitcoin and ether ETFs from the issuers' own files: iShares, Bitwise and ARK 21Shares for bitcoin, iShares and Bitwise for ether. History starts 20 August 2026.
- [Company pages](https://xoomar.com/markets/stocks): One page per US listed company with the SEC and FINRA series for that ticker: short interest, short volume, fails to deliver, insider trades, planned sales, large holders, 13F holders and financials, 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: private company raises and fund closes, many of them never announced, with amount sold, investor count, industry and exemption, updated 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.
- [Federal contracts](https://xoomar.com/markets/federal-contracts): The largest US federal contract actions each day from USAspending, with the listed parent company where there is one, the awarding agency and the amount obligated.
- [Earnings calendar](https://xoomar.com/markets/earnings): When US companies report results, from the filings themselves: 8-K Item 2.02 dates since January 2023 and the next expected date per company, marked as an estimate.

## Entity pages

- Companies: https://xoomar.com/markets/stocks/{ticker}, lowercase ticker, for example [AAPL](https://xoomar.com/markets/stocks/aapl).
- Funds: https://xoomar.com/markets/funds/{slug}, for example [Berkshire Hathaway](https://xoomar.com/markets/funds/berkshire-hathaway).
- Coins, funding and open interest: https://xoomar.com/markets/funding-rates/{slug}, for example [BTC](https://xoomar.com/markets/funding-rates/btc).
- Coins, whale positions: https://xoomar.com/markets/whales/{coin}, lowercase coin, for example [BTC](https://xoomar.com/markets/whales/btc).
- Economic releases: https://xoomar.com/markets/calendar/{release}, for example [CPI](https://xoomar.com/markets/calendar/cpi).
- COT markets: https://xoomar.com/markets/cot/{slug}, using the market slug from the COT API.
- Policy rates: https://xoomar.com/markets/rates/{country}, lowercase BIS area code, for example [US](https://xoomar.com/markets/rates/us).
- Sentiment: https://xoomar.com/markets/sentiment/{slug}, using the asset slug from the sentiment API.
- Structured note issuers: https://xoomar.com/markets/structured-products/issuer/{slug}, for example [JPMorgan](https://xoomar.com/markets/structured-products/issuer/jpmorgan).

Market JSON responses include canonicalUrl for the matching page. An entity record may also include canonicalUrl. Use that URL for the Data: XOOMAR link.

## API

- [API reference](https://xoomar.com/markets/api): every endpoint, parameter and field; JSON envelope {data, updatedAt, source, docs, license, attribution, meta}, where meta.sourceAttribution is the credit line for the data's publisher; CSV at /api/markets/{dataset}/csv
- GET https://xoomar.com/api/markets/funding-rates: Live funding rates on Binance, Bybit, OKX, Hyperliquid and Kraken Futures, with interval and annualized figures
- GET https://xoomar.com/api/markets/open-interest/{slug}: Open interest history per symbol, hourly from Binance since 2021
- GET https://xoomar.com/api/markets/cot: Weekly CFTC positioning by trader group, 360+ markets with a current report
- GET https://xoomar.com/api/markets/sentiment: One sentiment reading per asset from -1 to +1, 26 assets, updated every five minutes
- GET https://xoomar.com/api/markets/signals/{slug}: One composite reading per asset from -1 to +1, updated every 5 minutes, 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: Live crypto liquidations by venue, hourly history
- GET https://xoomar.com/api/markets/insiders: SEC Form 4 insider trades across US listed companies
- GET https://xoomar.com/api/markets/funds/{slug}: 13F portfolios of 30 tracked managers, quarterly since Q4 2020
- 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 bitcoin and ether ETF holdings from the issuers' own files and the net flows derived from them, since 20 August 2026
- GET https://xoomar.com/api/markets/calendar: Scheduled US releases from the agencies' own calendars: 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 38 economies with a current series (49 in the archive), history from 1945
- GET https://xoomar.com/api/markets/short-interest: FINRA biweekly short interest with days to cover, every US symbol, since December 2017
- 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: Treasury auction results 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: Form D filings: private company raises and fund closes, updated 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

- 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)
- Python: pip install xoomar (https://pypi.org/project/xoomar/)
- JavaScript and TypeScript: npm install xoomar (https://www.npmjs.com/package/xoomar)
- [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, limits, 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)