xoomar

Python client for the XOOMAR free market data API: 32 datasets from primary sources (SEC EDGAR and XBRL, FINRA, CFTC, the Federal Reserve, USAspending, exchange APIs) as clean JSON, no key needed to start.

pip install xoomar

from xoomar import Xoomar

x = Xoomar()                          # 30 requests a minute; Xoomar(api_key="...") for 120 with a free key

x.short_interest("GME")[0]            # FINRA short interest, newest settlement first
x.short_volume("GME", days=30)        # FINRA daily short sale volume (since 2021)
x.fails_to_deliver("GME", from_="2010-01-01", limit=5000)   # whole history in one call
x.insiders("NVDA", from_="2024-01-01")   # SEC Form 4 trades, filings since 2020
x.liquidation_events("BTC", min_usd=100000)   # individual liquidations, newest first
x.liquidation_history("BTC", from_="2026-07-01")   # hourly totals since June 2026
x.large_holders("HIMS")               # Schedule 13D and 13G holders
x.financials("AAPL")["quarterly"]     # XBRL income statement by quarter
x.fund_holders("AMZN")                # which tracked 13F managers hold it
x.cot("gold")                         # CFTC positioning history
x.fed_liquidity()[-1]                 # net liquidity, oldest first, so [-1] is this week
x.funding_rates()                     # perpetual funding on three exchanges
x.bitcoin_treasuries()                # bitcoin on public balance sheets
x.form_d(days=7)                      # private placements filed this week
x.federal_contracts(ticker="LMT")     # federal contract actions
x.insider_clusters(days=30)           # companies where 3+ insiders bought on the open market
x.threshold_list(symbol="GME")        # Reg SHO threshold list days (Nasdaq and Cboe, since 2022)
x.treasury_auctions(term="10-Year")   # Treasury auction results since 2010
x.earnings("NVDA")["next"]            # next expected earnings date (estimated from last year's 8-K)
x.earnings(to="2026-10-31")           # the calendar: reported and estimated rows

Every method returns the data part of the response. History endpoints keep the API's own order (short interest, insiders and COT newest first; short volume, fails to deliver and Fed liquidity oldest first), each row carries its date, so sort if you need one direction; x.last_meta holds updatedAt, source, license and attribution from the last call. x.get("short-interest", symbol="TSLA") calls any endpoint directly and x.csv("short-interest/csv") fetches a CSV download.

Full endpoint reference, fields and limits: https://xoomar.com/markets/api

Datasets

Short interest, daily short volume, fails to deliver, insider trades (Form 4), planned sales (Form 144), large holders (13D/13G), 13F fund holdings, company financials and buybacks (XBRL), 8-K events, structured products, federal contracts, Form D private placements, the IPO pipeline, bitcoin treasuries, Reg SHO threshold lists, Treasury auctions, insider cluster buying, CFTC COT, funding rates, open interest, liquidations, options, whale positions, sentiment, signals, ETF flows, prediction markets, Fed liquidity, macro, policy rates, economic calendar.

Rate limits and keys

30 requests a minute per IP without a key. A free account at https://xoomar.com/signup gives a key for 120 a minute; pass it as Xoomar(api_key=...). A 429 raises XoomarRateLimited with retry_after.

Data terms

When you republish the data, on a site, in an app, in an article, in a dataset or a chart, credit XOOMAR with a visible link to the dataset page on xoomar.com. What you may do with the data is set out at https://xoomar.com/terms.

License

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