# ToolMint Corp Intel

> US public-company brief: SEC EDGAR identity + recent filings + Federal Register quoted-phrase search in one call.

- Status: Coming soon
- Price: $0.05 / call (x402 exact, USDC on Base eip155:8453, payTo 0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5)
- Planned URL: https://toolmint-corp-intel.toolmint.workers.dev
- OpenAPI: https://toolmint.toolmint.workers.dev/tools/corp-intel/openapi.json

## Routes

- `GET /brief` $0.05: Company brief by ticker/CIK query
- `GET /brief/{ticker}` $0.05: Company brief by path

## What question it answers

"Who is this company, what has it filed recently with the SEC, and has it been named in any Federal Register documents?"

## When to use it

- You have a ticker or CIK and want filing links plus basic identity (name, exchanges, SIC code, fiscal year end, state of incorporation) in one response.

## When not to use it

- Financial data or analysis. It returns an index of filings and links, no financial statements, and it is not investment advice.
- Companies that do not file with the SEC, or non-US issuers.
- Reading older filings. Only the SEC "recent" list is used, up to 25 filings.
- Legal conclusions. Federal Register hits are a quoted-name keyword search, not a finding that a document is about this company.

## Example

```bash
curl -i "https://toolmint-corp-intel.toolmint.workers.dev/brief?ticker=AAPL&filings=3&fr=2"
# 402 + PAYMENT-REQUIRED. Pay with an x402 client, repeat with PAYMENT-SIGNATURE.
```

Response after payment (trimmed; this is the Worker's own example block, so the values are illustrative):

```json
{
  "tool": "corp-intel-brief",
  "version": "0.1.0",
  "query": "AAPL",
  "company": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "exchanges": ["Nasdaq"],
    "sic": "3571",
    "sicDescription": "Electronic Computers"
  },
  "filings": [
    {
      "form": "10-K",
      "filingDate": "2025-11-01",
      "accessionNumber": "0000320193-25-000001",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/..."
    }
  ],
  "federalRegister": {
    "count": 3,
    "matchedOn": "\"Apple Inc\"",
    "results": [
      {
        "title": "Example FR document",
        "documentNumber": "2025-00001",
        "publicationDate": "2025-06-01",
        "agencies": ["Securities and Exchange Commission"]
      }
    ]
  },
  "notAdvice": "Public filings index only; not investment advice",
  "cached": false,
  "sourceFetchedAt": {
    "secTickers": "2026-10-31T16:00:00.000Z",
    "secSubmissions": "2026-10-31T16:00:01.000Z",
    "federalRegister": "2026-10-31T16:00:02.000Z"
  }
}
```

A real response also has `sources`, `fetchedAt`, `licensing`, `notes`, more company fields (`category`, `fiscalYearEnd`, `stateOfIncorporation`) and, per filing, `reportDate`, `primaryDocument`, `description`.

## Data sources and licence

SEC EDGAR (`www.sec.gov`, `data.sec.gov`): public domain, US government work. Federal Register API: US government work. Not endorsed by the SEC, NARA or the Office of the Federal Register. Check the sources' terms if you redistribute.

## Freshness and limits

- A brief is cached for 30 minutes in memory on one server instance; the SEC ticker list for 24 hours. `cached` and `sourceFetchedAt` show what you got and when each source was fetched.
- Federal Register matching searches the company name with punctuation removed ("AT&T Inc." becomes "ATT Inc"), so some names will miss documents.
- A name-only query matches by substring on SEC company names and returns at most 10 candidates.
- The service calls SEC and the Federal Register itself and does not currently enforce SEC's 10-requests-per-second guideline in code. The review recommends a rate-limit rule at the Cloudflare layer; it is not set up yet.
- If it runs out, paid calls fail and are not charged.