# XOOMAR

> Free US market data from primary sources: SEC insider trades, planned insider sales, 5% holders, fund portfolios, company financials, 8-K events, earnings dates, IPO and Form D filings; FINRA short interest, short volume and fails to deliver; the economic calendar, central bank rates, Fed liquidity and CFTC futures positioning. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/xoomar

## Actions

### Find insider buying clusters

Find companies where several different insiders bought shares on the open market within the same window, a pattern many investors read as a vote of confidence. Sorted by number of buyers, then by value, with each buyer listed. No API key required.

**Inputs**

- Days back (`days`, number): How many days back to look, up to 365. Leave blank for 30. From 1 to 365.
- Minimum buyers (`min_insiders`, number): How many different insiders must have bought, from 2 to 20. Leave blank for 3. From 2 to 20.
- Minimum total (USD) (`min_value_usd`, number): Only companies where the purchases add up to at least this many US dollars. Leave blank for any amount. At least 0.
- Stock ticker (`ticker`, text): Check one company only. Leave blank for all.
- Maximum companies (`limit`, number): The most companies to return, up to 500. Leave blank for 100. From 1 to 500.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `clusters` (list): One row per company, most buyers first.
- `count` (number): How many rows came back.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Insider trade data: SEC.",
  "clusters": [
    {
      "buyers": [
        {
          "name": "BAILLY R JEFFREY",
          "title": "Director",
          "value_usd": 500000
        },
        {
          "name": "FLORNESS DANIEL L",
          "title": "Director",
          "value_usd": 100160.2
        }
      ],
      "company": "FULLER H B CO",
      "first_trade_date": "2026-09-28",
      "insider_count": 8,
      "latest_filed_date": "2026-10-08",
      "latest_trade_date": "2026-10-07",
      "shares": 22581.599,
      "ticker": "FUL",
      "trade_count": 10,
      "value_usd": 1121315.6079
    }
  ],
  "count": 1,
  "updated_at": "2026-10-15T21:34:54.849Z"
}
```

### Get a central bank rate

Get a central bank's policy interest rate (the Fed, the ECB, the Bank of England and 35 more) with when it last changed and its day-by-day history, from the Bank for International Settlements. No API key required.

**Inputs**

- Country (`country`, text, required): The economy whose central bank rate to get.
- From (`start_date`, date): The first day to include. Leave blank to start from the earliest day the free API offers (about six months back).
- To (`end_date`, date): The last day to include. Leave blank for up to the latest day.
- Changes only (`changes_only`, true/false): Return only the days the rate changed. Default: `false`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `country` (text): The economy's name.
- `country_code` (text): Its code, e.g. US, GB or XM for the euro area.
- `current_rate` (number): The policy rate now, in percent.
- `history` (list): The rate day by day, newest first.
- `last_changed` (text): When the rate last changed.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Policy rate data: BIS.",
  "count": 1,
  "country": "United States",
  "country_code": "US",
  "current_rate": 3.875,
  "history": [
    {
      "changed": true,
      "date": "2026-09-17",
      "rate": 3.875
    }
  ],
  "last_changed": "2026-09-17",
  "updated_at": "2026-10-15T21:37:37.946Z"
}
```

### Get a company's earnings dates

See when a company reported earnings in the past (from its SEC 8-K filings, back to 2023) and when its next report is expected. No API key required.

**Inputs**

- Stock ticker (`ticker`, text, required): The company's US stock ticker, such as AAPL.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `cik` (text): Its SEC CIK number.
- `company` (text): The company's name.
- `count` (number): How many rows came back.
- `history` (list): Past earnings releases, newest first.
- `last_reported_date` (text): The most recent earnings release.
- `next_date` (text): The next expected earnings date.
- `next_date_estimated_from` (text): The past release the next date was projected from.
- `next_date_status` (text): estimated until the company confirms it.
- `ticker` (text): The company's ticker.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Earnings dates: SEC.",
  "cik": "320193",
  "company": "Apple Inc.",
  "count": 1,
  "history": [
    {
      "accession_number": "0000320193-26-000018",
      "date": "2026-07-30"
    }
  ],
  "last_reported_date": "2026-07-30",
  "next_date": "2026-10-29",
  "next_date_estimated_from": "2025-10-30",
  "next_date_status": "estimated",
  "ticker": "AAPL",
  "updated_at": "2026-07-30T00:00:00.000Z"
}
```

### Get a company's insider trades

See every trade a company's insiders reported on SEC Form 4 (purchases, sales, option exercises, awards and gifts), newest first, with totals for open-market buying and selling. Covers about the last six months. No API key required.

**Inputs**

- Stock ticker (`ticker`, text, required): The company's US stock ticker, such as AAPL.
- From (`start_date`, date): The first day to include. Leave blank to start from the earliest day the free API offers (about six months back).
- To (`end_date`, date): The last day to include. Leave blank for up to the latest day.
- Maximum trades (`limit`, number): The most trades to return, up to 2,000. Leave blank for 200. From 1 to 2000.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `open_market_buy_count` (number): How many of the trades were open-market purchases.
- `open_market_buy_value_usd` (number): The purchases' combined value, in US dollars.
- `open_market_sell_count` (number): How many were open-market sales.
- `open_market_sell_value_usd` (number): The sales' combined value, in US dollars.
- `ticker` (text): The ticker asked about.
- `trades` (list): The trades, newest first.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Insider trade data: SEC.",
  "count": 1,
  "open_market_buy_count": 0,
  "open_market_buy_value_usd": 0,
  "open_market_sell_count": 1,
  "open_market_sell_value_usd": 13651133.26,
  "ticker": "AAPL",
  "trades": [
    {
      "insider_name": "COOK TIMOTHY D",
      "insider_title": "Executive Chair",
      "is_open_market": true,
      "price_note": null,
      "price_per_share": 333.94,
      "shares": 40879,
      "shares_owned_after": 3264168,
      "ticker": "AAPL",
      "trade_date": "2026-10-02",
      "transaction_code": "S",
      "transaction_type": "Open-market sale",
      "value_usd": 13651133.26
    }
  ],
  "updated_at": "2026-10-15T21:34:46.025Z"
}
```

### Get a fund's holdings

See what a well-known investment manager (Berkshire Hathaway, Pershing Square, Bridgewater and 27 more) held at the end of the latest quarter, from its SEC 13F filing: every position with its value, share of the portfolio and change since the quarter before. No API key required.

**Inputs**

- Fund (`fund`, text, required): The investment manager whose portfolio to get.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `cik` (text): The fund's SEC CIK number.
- `count` (number): How many rows came back.
- `fund` (text): XOOMAR's id for the fund, as picked.
- `fund_name` (text): The fund's name.
- `holdings` (list): Every position, largest first.
- `manager` (text): The person best known for running it.
- `quarter_end` (text): The quarter end the holdings are as of.
- `total_value_usd` (number): All the positions' value, added up, in US dollars.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). 13F holdings data: SEC.",
  "cik": "1067983",
  "count": 1,
  "fund": "berkshire-hathaway",
  "fund_name": "Berkshire Hathaway",
  "holdings": [
    {
      "change_in_shares": 0,
      "company": "APPLE INC",
      "cusip": "037833100",
      "option_type": null,
      "percent_of_portfolio": 22.0383,
      "shares": 227917808,
      "ticker": "AAPL",
      "value_usd": 65950296923
    }
  ],
  "manager": "Warren Buffett",
  "quarter_end": "2026-06-30",
  "total_value_usd": 65950296923,
  "updated_at": "2026-10-15T21:37:08.519Z"
}
```

### Get company financials

Get a US-listed company's results as filed with the SEC: quarterly revenue, net income and earnings per share; yearly revenue, cash flow, capital spending, buybacks and dividends; and its latest balance sheet. Newest period first. No API key required.

**Inputs**

- Stock ticker (`symbol`, text, required): The company's US stock ticker, such as AAPL.

**Outputs**

- `annual` (list): Yearly results, newest first.
- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `balance_sheet` (object): The latest balance sheet.
- `cik` (text): Its SEC CIK number.
- `company` (text): The company's name.
- `quarterly` (list): Quarterly results, newest first.
- `ticker` (text): The company's ticker.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "annual": [
    {
      "buybacks": 90711000000,
      "capital_expenditure": 12715000000,
      "dividends": 15421000000,
      "fiscal_year": "FY 2025",
      "net_income": 112010000000,
      "operating_cash_flow": 111482000000,
      "period_end": "2025-09-27",
      "revenue": 416161000000
    }
  ],
  "attribution": "Data: XOOMAR (https://xoomar.com). Financial statement data: SEC.",
  "balance_sheet": {
    "as_of": "2026-06-27",
    "assets": 383266000000,
    "cash": 39544000000,
    "debt": 82300000000,
    "equity": 107520000000,
    "form": "10-Q",
    "shares_as_of": "2026-07-17",
    "shares_outstanding": 14594180000
  },
  "cik": "320193",
  "company": "Apple Inc.",
  "quarterly": [
    {
      "derived_from_annual": false,
      "eps_diluted": 2.02,
      "fiscal_period": "Q3 FY 2026",
      "fiscal_year": "FY 2026",
      "net_income": 29789000000,
      "period_end": "2026-06-27",
      "revenue": 109417000000
    }
  ],
  "ticker": "AAPL",
  "updated_at": "2026-10-15T21:35:30.000Z"
}
```

### Get daily short volume

See what share of each day's trading in a stock was short selling, from FINRA's daily short sale volume files. Give a ticker for its day-by-day history, or leave it blank for the latest day's stocks with the highest short share of volume. No API key required.

**Inputs**

- Stock ticker (`symbol`, text): A US stock ticker such as AAPL; class shares are written BRK-B. Leave blank to see the whole market instead of one stock.
- From (`start_date`, date): The first day to include. Leave blank to start from the earliest day the free API offers (about six months back).
- To (`end_date`, date): The last day to include. Leave blank for up to the latest day.
- Maximum days (`limit`, number): The most rows to return, newest first, up to 5,000. Leave blank for 60 days for one stock. From 1 to 5000.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `records` (list): Newest day first for one stock; for the whole market, the latest day's stocks.
- `symbol` (text): The ticker asked about, or null for the whole-market view.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Short sale volume data: FINRA. FINRA is the owner and source of this data.",
  "count": 1,
  "records": [
    {
      "date": "2026-10-14",
      "short_exempt_volume": 20736,
      "short_percent_of_volume": 55.39,
      "short_volume": 4317353,
      "symbol": "GME",
      "total_volume": 7793859
    }
  ],
  "symbol": "GME",
  "updated_at": "2026-10-15T21:33:58.408Z"
}
```

### Get fails to deliver

See the shares of a stock that sellers failed to deliver on time, from the SEC's fails-to-deliver data. Give a ticker for its history by settlement date, or leave it blank for the latest day's largest fails by dollar value. No API key required.

**Inputs**

- Stock ticker (`symbol`, text): A US stock ticker such as AAPL; class shares are written BRK-B. Leave blank to see the whole market instead of one stock.
- From (`start_date`, date): The first day to include. Leave blank to start from the earliest day the free API offers (about six months back).
- To (`end_date`, date): The last day to include. Leave blank for up to the latest day.
- Maximum rows (`limit`, number): The most rows to return, newest first, up to 5,000. Leave blank for all of them. From 1 to 5000.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `fails` (list): Newest settlement date first for one stock; for the whole market, the latest day's largest fails.
- `symbol` (text): The ticker asked about, or null for the whole-market view.
- `total_quantity` (number): All the failed shares in the rows, added up.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Fails-to-deliver data: SEC.",
  "count": 1,
  "fails": [
    {
      "company": "GAMESTOP CORP (HLDG CO) CL A",
      "cusip": "36467W109",
      "price": 21.15,
      "quantity": 7568,
      "settlement_date": "2026-09-14",
      "symbol": "GME",
      "value_usd": 160063.2
    }
  ],
  "symbol": "GME",
  "total_quantity": 7568,
  "updated_at": "2026-10-15T21:34:07.418Z"
}
```

### Get Fed liquidity

Track the Federal Reserve's balance sheet week by week: total assets, bank reserves, the Treasury's cash account, the reverse repo facility and the resulting net liquidity many investors watch. No API key required.

**Inputs**

- Weeks (`weeks`, number): How many recent weeks to return, up to 520. Leave blank for 12. From 1 to 520.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.
- `weeks` (list): One row per week, newest first. Amounts in US dollars.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Fed liquidity data: FRED (Federal Reserve Bank of St. Louis). This product uses the FRED\u00ae API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.",
  "count": 1,
  "updated_at": "2026-10-15T21:37:50.329Z",
  "weeks": [
    {
      "bank_reserves": 3029659000000,
      "date": "2026-10-07",
      "net_liquidity": 5864969000000,
      "reverse_repo": 2338000000,
      "total_assets": 6747560000000,
      "treasury_general_account": 880253000000
    }
  ]
}
```

### Get futures positioning (COT)

See who is long and who is short a futures market (gold, oil, the S&P 500, the euro, Treasuries and 350 more) from the CFTC's weekly Commitments of Traders report: each trader group's position and the speculators' net position, week by week. No API key required.

**Inputs**

- Market (`market`, text, required): The futures market.
- From (`start_date`, date): The first day to include. Leave blank to start from the earliest day the free API offers (about six months back).
- To (`end_date`, date): The last day to include. Leave blank for up to the latest day.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `group` (text): Its asset class, e.g. metals or currencies.
- `market` (text): The market's CFTC name.
- `market_slug` (text): The market as picked.
- `report_type` (text): Financial futures or Commodities, which decides the trader groups the CFTC reports.
- `reports` (list): The weekly reports, newest first.
- `speculator_group` (text): The group speculator_net is for: Leveraged funds or Managed money.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Commitments of Traders data: CFTC.",
  "count": 1,
  "group": "metals",
  "market": "GOLD",
  "market_slug": "gold",
  "report_type": "Commodities",
  "reports": [
    {
      "open_interest": 396109,
      "positions": [
        {
          "long": 18860,
          "net": -19501,
          "short": 38361,
          "trader_group": "Producers and merchants"
        },
        {
          "long": 14604,
          "net": -225026,
          "short": 239630,
          "trader_group": "Swap dealers"
        },
        {
          "long": 127101,
          "net": 110987,
          "short": 16114,
          "trader_group": "Managed money"
        },
        {
          "long": 118302,
          "net": 99348,
          "short": 18954,
          "trader_group": "Other large traders"
        },
        {
          "long": 50464,
          "net": 34192,
          "short": 16272,
          "trader_group": "Small traders"
        }
      ],
      "report_date": "2026-10-06",
      "speculator_net": 110987
    }
  ],
  "speculator_group": "Managed money",
  "updated_at": "2026-10-15T21:41:19.354Z"
}
```

### Get short interest

See how many shares of a stock are sold short and how many days it would take short sellers to buy them back, from FINRA's twice-monthly reports. Give a ticker for its history back about six months, or leave it blank for the stocks with the most days to cover in the latest report. No API key required.

**Inputs**

- Stock ticker (`symbol`, text): A US stock ticker such as AAPL; class shares are written BRK-B. Leave blank to see the whole market instead of one stock.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `reports` (list): Newest report first for one stock; for the whole market, the latest report's stocks by days to cover.
- `symbol` (text): The ticker asked about, or null for the whole-market view.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Short interest data: FINRA. FINRA is the owner and source of this data.",
  "count": 1,
  "reports": [
    {
      "average_daily_volume": 10727887,
      "change_percent": 9.23,
      "days_to_cover": 3.98,
      "settlement_date": "2026-09-30",
      "short_shares": 42673721,
      "symbol": "GME"
    }
  ],
  "symbol": "GME",
  "updated_at": "2026-10-15T21:38:38.720Z"
}
```

### Get the earnings calendar

See which US companies report earnings when: dates already reported (confirmed by an SEC 8-K) and the next expected ones, each labelled. Leave the dates blank for the next two weeks. No API key required.

**Inputs**

- From (`start_date`, date): The first day to include. Leave blank for today.
- To (`end_date`, date): The last day to include, at most 120 days after the first. Leave blank for two weeks after it.
- Show (`status`, text): Reported dates, expected dates, or both. One of: `all` (Reported and expected), `reported` (Reported only), `estimated` (Expected only). Default: `all`.
- Stock ticker (`ticker`, text): One company's ticker. Leave blank for every company.
- Maximum rows (`limit`, number): The most dates to return, up to 2,000. Leave blank for 500. From 1 to 2000.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `releases` (list): Earnings dates, earliest first.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Earnings dates: SEC.",
  "count": 1,
  "releases": [
    {
      "accession_number": null,
      "cik": "1390777",
      "company": "Bank of New York Mellon Corp  (BNY, BNY-PK)",
      "date": "2026-10-15",
      "estimated_from": "2025-10-16",
      "status": "estimated",
      "ticker": "BNY"
    }
  ],
  "updated_at": "2026-10-14T00:00:00.000Z"
}
```

### Get the economic calendar

See scheduled US economic releases (CPI, PPI, jobs, jobless claims, PCE, GDP, retail sales, housing and Fed rate decisions) from the agencies' own calendars, with the actual figure once it is out. Leave the dates blank for the last week and the month ahead. No API key required.

**Inputs**

- From (`start_date`, date): The first day to include. Leave blank for a week ago.
- To (`end_date`, date): The last day to include. Leave blank for 30 days ahead.
- Importance (`importance`, text): Only releases of this importance. One of: `all` (All releases), `high` (High importance), `med` (Medium importance), `low` (Low importance). Default: `all`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `releases` (list): The releases, earliest first.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Release dates and figures: Bureau of Labor Statistics, Bureau of Economic Analysis, Census Bureau, Federal Reserve Board, FRED (Federal Reserve Bank of St. Louis) and U.S. Treasury.",
  "count": 1,
  "releases": [
    {
      "actual": 3.7,
      "agency": "Bureau of Labor Statistics",
      "event": "CPI (Consumer Price Index)",
      "forecast": null,
      "importance": "high",
      "period": "September 2026",
      "previous": 3.4,
      "released": true,
      "scheduled_at": "2026-10-14T12:30:00.000Z",
      "unit": "% y/y, all items"
    }
  ],
  "updated_at": "2026-10-15T21:36:40.000Z"
}
```

### List company events (8-K)

See the material events companies reported to the SEC on Form 8-K (earnings, executive changes, deals, bankruptcies, cybersecurity incidents and more), each labelled in plain words with a link to the filing. Filter by company, by type of event, or both. No API key required.

**Inputs**

- Stock ticker (`ticker`, text): One company's ticker. Leave blank for every company.
- Event type (`event_type`, text): Only this kind of event. Leave blank for all. One of: `1.01` (1.01 Material agreement signed), `1.02` (1.02 Material agreement ended), `1.03` (1.03 Bankruptcy or receivership), `1.04` (1.04 Mine safety violation), `1.05` (1.05 Cybersecurity incident), `2.01` (2.01 Acquisition or sale of assets completed), `2.02` (2.02 Earnings results), `2.03` (2.03 New debt or financial obligation), `2.04` (2.04 Debt accelerated by a triggering event), `2.05` (2.05 Exit or restructuring costs), and 17 more.
- Days back (`days`, number): How many days back to look, up to 90. Leave blank for 7. From 1 to 90.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `events` (list): The 8-K filings, newest first, up to 200.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). 8-K event data: SEC.",
  "count": 1,
  "events": [
    {
      "accession_number": "0001140361-26-035325",
      "company": "Apple Inc.",
      "event_types": [
        "Officer or director change"
      ],
      "filed_at": "2026-09-01T20:30:35.000Z",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/0001140361-26-035325-index.htm",
      "items": [
        "5.02"
      ],
      "summary": "Officer or director change",
      "ticker": "AAPL"
    }
  ],
  "updated_at": "2026-10-15T21:35:51.025Z"
}
```

### List IPO filings

Follow the IPO pipeline: companies registering to go public with the SEC, offerings that priced, registrations declared effective and ones withdrawn, each with the form explained. Newest first. No API key required.

**Inputs**

- Filing types (`form_types`, list): Which filings to include. Leave empty for new registration statements (S-1 and F-1). One or more of: `S-1` (S-1: registration statement (US company)), `S-1/A` (S-1/A: amended registration (US company)), `F-1` (F-1: registration statement (foreign company)), `F-1/A` (F-1/A: amended registration (foreign company)), `424B4` (424B4: final prospectus (offering priced)), `EFFECT` (EFFECT: registration declared effective), `RW` (RW: registration withdrawn).
- Days back (`days`, number): How many days back to look, up to 365. Leave blank for 90. From 1 to 365.
- First-time issuers only (`new_issuers_only`, true/false): Leave out companies whose shares already trade, so only true IPOs remain. Default: `false`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `filings` (list): The filings, newest first.
- `form_types` (list): The filing types searched.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). IPO filing data: SEC.",
  "count": 1,
  "filings": [
    {
      "accession_number": "0001683168-26-007889",
      "already_listed": false,
      "cik": "2155673",
      "company": "Cashlin",
      "filed_date": "2026-10-15",
      "first_registration_date": "2026-10-15",
      "form_description": "Registration statement (US company)",
      "form_type": "S-1",
      "offering_amount": null
    }
  ],
  "form_types": [
    "S-1",
    "F-1"
  ],
  "updated_at": "2026-10-15T21:36:00.000Z"
}
```

### List large shareholders

See investors who have disclosed owning more than 5% of a company, from SEC Schedule 13D (active stakes, often activists) and 13G (passive stakes) filings: the holder, shares and percent owned. Give a ticker for one company, or leave it blank for the latest filings market-wide. No API key required.

**Inputs**

- Stock ticker (`symbol`, text): A US stock ticker such as AAPL; class shares are written BRK-B. Leave blank to see the whole market instead of one stock.
- Filing type (`form`, text): 13D for active stakes (the holder may seek to influence the company), 13G for passive ones. One of: `13D` (Schedule 13D (active stakes)), `13G` (Schedule 13G (passive stakes)). Default: `13D`.
- Days back (`days`, number): How many days back to look, up to 365. Leave blank for 30. From 1 to 365.
- New stakes only (`new_filings_only`, true/false): Leave out amendments to earlier filings. Default: `false`.
- Order (`sort`, text): How to order the filings. One of: `filed` (Newest filings first), `percent` (Largest stakes first). Default: `filed`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `filings` (list): The filings, in the order asked for.
- `form` (text): 13D or 13G, as asked for.
- `symbol` (text): The ticker asked about, or null for the whole-market view.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Schedule 13D and 13G data: SEC.",
  "count": 1,
  "filings": [
    {
      "accession_number": "0002100119-26-000139",
      "amendment_number": null,
      "company": "Apple Inc",
      "cusip": "037833100",
      "event_date": "2026-03-31",
      "filed_date": "2026-04-29",
      "form_type": "SCHEDULE 13G",
      "holder_name": "Vanguard Capital Management",
      "holder_type": "IA",
      "percent_of_class": 7.48,
      "security_class": "Common Stock",
      "shares_owned": 1099168953,
      "ticker": "AAPL"
    }
  ],
  "form": "13G",
  "symbol": "AAPL",
  "updated_at": "2026-10-15T21:35:11.522Z"
}
```

### List planned insider sales

See insiders' notices of shares they intend to sell (SEC Form 144), usually filed the day a sale starts: who is selling, how many shares, their value and the broker. Give a ticker for one company, or leave it blank for the whole market. No API key required.

**Inputs**

- Stock ticker (`symbol`, text): A US stock ticker such as AAPL; class shares are written BRK-B. Leave blank to see the whole market instead of one stock.
- Days back (`days`, number): How many days back to look, up to 365. Leave blank for 30. From 1 to 365.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `notices` (list): The Form 144 notices, newest first.
- `symbol` (text): The ticker asked about, or null for the whole-market view.
- `total_market_value_usd` (number): The notices' combined market value, in US dollars.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Form 144 data: SEC.",
  "count": 1,
  "notices": [
    {
      "accession_number": "0001959173-26-007235",
      "approximate_sale_date": "2026-10-02",
      "broker": "Fidelity Brokerage Services LLC",
      "company": "Apple Inc.",
      "exchange": "NASDAQ",
      "filed_date": "2026-10-02",
      "market_value_usd": 3329584,
      "relationship": "Officer, Director",
      "security_class": "Common Stock",
      "seller_name": "COOK TIMOTHY D",
      "shares_outstanding": 14594180000,
      "shares_to_sell": 218078,
      "ticker": "AAPL"
    }
  ],
  "symbol": "AAPL",
  "total_market_value_usd": 3329584,
  "updated_at": "2026-10-15T21:35:00.000Z"
}
```

### List private fundraises (Form D)

See money raised privately by startups, companies and investment funds, from the Form D filings they make with the SEC: amount raised, number of investors, industry and state. Largest raises first, or newest. No API key required.

**Inputs**

- Days back (`days`, number): How many days back to look, up to 365. Leave blank for 30. From 1 to 365.
- Raised by (`issuer_type`, text): Operating companies (startups included) or investment funds. One of: `companies`, `funds` (Investment funds). Default: `companies`.
- Order (`sort`, text): How to order the raises. Newest first reads the latest 100 filings of every kind, so it can return fewer rows. One of: `largest` (Largest raises first), `recent` (Newest filings first). Default: `largest`.
- Include updates (`include_amendments`, true/false): Also include amended filings that update an earlier raise. Default: `false`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `offerings` (list): The raises, in the order asked for, up to 100.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Form D data: SEC.",
  "count": 1,
  "offerings": [
    {
      "accession_number": "0002094470-26-000002",
      "cik": "2094470",
      "entity_type": "Corporation",
      "filed_date": "2026-10-15",
      "first_sale_date": "2026-09-30",
      "fund_type": null,
      "industry": "Other Technology",
      "investor_count": 34,
      "is_amendment": false,
      "issuer_name": "Armadin, Inc.",
      "minimum_investment": 0,
      "revenue_range": "Decline to Disclose",
      "security_types": "equity",
      "state": "CA",
      "total_amount_sold": 264999494,
      "total_offering_amount": 264999494
    }
  ],
  "updated_at": "2026-10-15T21:38:18.455Z"
}
```

### List recent insider trades

See the latest open-market stock purchases or sales by company insiders (officers, directors and 10% owners) across every US listed company, from their SEC Form 4 filings. Newest first, up to 100 trades. No API key required.

**Inputs**

- Trades (`trade_type`, text): Purchases or sales. One of: `buys` (Purchases), `sells` (Sales). Default: `buys`.
- Period (`period`, text): How far back to look. One of: `7d` (Last 7 days), `30d` (Last 30 days), `90d` (Last 90 days). Default: `30d`.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `count` (number): How many rows came back.
- `total_value_usd` (number): The trades' combined value, in US dollars.
- `trade_type` (text): buys or sells, as asked for.
- `trades` (list): The trades, newest first.
- `updated_at` (text): When XOOMAR built this answer (ISO 8601), or for daily feeds the date of their newest row.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Insider trade data: SEC.",
  "count": 1,
  "total_value_usd": 3542550,
  "trade_type": "buys",
  "trades": [
    {
      "insider_name": "Troim Tor Olav",
      "insider_title": "Director",
      "is_open_market": true,
      "price_note": null,
      "price_per_share": 4.7234,
      "shares": 750000,
      "shares_owned_after": null,
      "ticker": "BORR",
      "trade_date": "2026-10-14",
      "transaction_code": "P",
      "transaction_type": "Open-market purchase",
      "value_usd": 3542550
    }
  ],
  "updated_at": "2026-10-15T21:35:00.000Z"
}
```

### Look up a company's SEC filings

Look up any company that files with the SEC by ticker, CIK number or name: how many filings it made in the last twelve months, by form, and its most recent filings with links to read them. No API key required.

**Inputs**

- Company (`company`, text, required): A ticker (AAPL), a CIK number (320193) or a company name.

**Outputs**

- `attribution` (text): The credit line XOOMAR asks you to show when you publish this data: 'Data: XOOMAR' plus the original source, e.g. 'Short interest data: FINRA.'
- `cik` (text): Its SEC CIK number.
- `company` (text): The company's name.
- `company_page_url` (text): XOOMAR's page for the company.
- `count` (number): How many recent filings came back.
- `filings_by_form` (list): That count broken down by form, most common first.
- `filings_last_12_months` (number): Filings made in the last twelve months.
- `recent_filings` (list): The most recent filings, newest first.
- `ticker` (text): Its ticker.

**Example output**

```json
{
  "attribution": "Data: XOOMAR (https://xoomar.com). Filing data: SEC.",
  "cik": "320193",
  "company": "Apple Inc.",
  "company_page_url": "https://xoomar.com/markets/stocks/aapl",
  "count": 1,
  "filings_by_form": [
    {
      "count": 50,
      "form": "4"
    },
    {
      "count": 12,
      "form": "144"
    }
  ],
  "filings_last_12_months": 85,
  "recent_filings": [
    {
      "filed_date": "2026-10-08",
      "form": "4",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/xslF345X06/form4.xml"
    }
  ],
  "ticker": "AAPL"
}
```