# Regulatory Filings (`filings_search`)

> Full-text search across recent regulatory filings, with form type, filer, and a link to the document itself.

- Category: News & filings
- MCP tool: `filings_search`
- REST: `GET /filings`
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/filings_search

## What it does

Searches recent regulatory filings (full-text) for a company, ticker, or theme (e.g. 'bitcoin treasury'). Returns the most recent matching filings with form type, filer, and a direct document link.

## Parameters

| Name | Type | In | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | string | query | yes | Free-text query, e.g. a company name, ticker, or theme. |

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/filings?query=bitcoin+ETF" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filings_search",
    "arguments": {
      "query": "bitcoin ETF"
    }
  }
}
```

### TypeScript

```ts
const res = await fetch("https://mcp.f1ow.com/v1/filings?query=bitcoin+ETF", {
  headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);
```

### Python

```python
import os, requests

res = requests.get(
    "https://mcp.f1ow.com/v1/filings?query=bitcoin+ETF",
    headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json()  # the tool's result as JSON, typed in the OpenAPI spec
print(data)
```

### WebSocket

```jsonc
// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filings_search",
    "arguments": {
      "query": "bitcoin ETF"
    }
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "filings_search",
    "arguments": {
      "query": "bitcoin ETF"
    },
    "intervalSeconds": 60
  }
}
```

### x402

```bash
# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/filings?query=bitcoin+ETF"
```

## Sample response

Captured 2026-11-13. The JSON is what REST and WebSocket return and the `structuredContent` of an MCP call (trimmed):

```json
{
  "filings": [
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025328/cls-primary-document.htm"
    },
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025257/cls-primary-document.htm"
    },
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025307/cls-primary-document.htm"
    },
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025262/cls-primary-document.htm"
    },
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025219/cls-primary-document.htm"
    },
    {
      "company": "PROSHARES TRUST  (CIK 0001174610)",
      "description": "PART-FS",
      "filedDate": "2026-10-28",
      "form": "NPORT-P",
      "url": "https://www.sec.gov/Archives/edgar/data/1174610/000207169126025313/cls-primary-document.htm"
    },
    "… 9 more"
  ],
  "generatedAt": "2026-11-13T08:05:48.9251555+00:00"
}
```

Over MCP the text report a model reads comes with it:

```text
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025328/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025257/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025307/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025262/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025219/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025313/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025299/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025230/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025343/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025296/cls-primary-document.htm
2026-10-28 | NPORT-P | PROSHARES TRUST  (CIK 0001174610)
  PART-FS
  https://www.sec.gov/Archives/edgar/data/1174610/000207169126025336/cls-primary-document.htm
2026-09-28 | 497K | PROSHARES TRUST  (CIK 0001174610)
  PROSHARES ULTRASHORT BITCOIN ETF
  https://www.sec.gov/Archives/edgar/data/1174610/000117461026000965/f46119d1.htm
2026-08-28 | NPORT-P | SKYBRIDGE OPPORTUNITY FUND  (CIK 0001181848)
  NPORT-P
  https://www.sec.gov/Archives/edgar/data/1181848/000119312526373821/primary_doc.xml
2026-05-29 | NPORT-P | SKYBRIDGE OPPORTUNITY FUND  (CIK 0001181848)
  NPORT-P
  https://www.sec.gov/Archives/edgar/data/1181848/000119312526247337/primary_doc.xml
2026-05-08 | N-CSR | Volatility Shares Trust  (CIK 0001884021)
  VOLATILITY SHARES - N-CSR
  https://www.sec.gov/Archives/edgar/data/1884021/000113322826008134/vs-efp23432_ncsr.htm
```

## Related tools

- [News](https://www.f1ow.com/docs/tools/news_search) — Recent coverage on any topic, drawn from a crypto news aggregator and a live search model at the same time.
- [Market Regime](https://www.f1ow.com/docs/tools/research_regime) — What kind of market you are trading in. Seven forces — trend, volatility, cycle, sentiment, leverage stress, ETF liquidity, rotation — each voting with its own reasoning and its own threshold for changing the call.
- [Positioning](https://www.f1ow.com/docs/tools/research_positioning) — Who is on the other side of your trade. Up to eight reads on one coin — who is crowded, who is fragile, who is trapped — plus the price levels the whole board is watching.
- [Opportunity Scan](https://www.f1ow.com/docs/tools/research_opportunities) — A liquidity-qualified major and mid-cap universe screened on crowding, stress, leverage, compression, trend, location and entry quality. Ranked candidates with disclosed setup rules and entry, stop and target geometry — not a forecast or a proven edge.