# SEC Filings API (mavisCrypto)

> Pay-per-request SEC EDGAR filings feed for AI agents. Two paid endpoints, USDC on Base via x402 - no account, no API key.

## Endpoints
1. `GET https://agentsapi.top/api/filings/today` — **$0.01 USDC**
   Latest SEC EDGAR filings for 10-K / 10-Q / 8-K, sorted by filing time descending, max 40 per call.
2. `GET https://agentsapi.top/api/filings/8k` — **$0.005 USDC**
   Real-time 8-K material-event stream (M&A, officer changes, earnings releases, delisting, bankruptcy), max 40 per call.

## Each filing includes
- form type, company name + CIK, filing time (UTC), EDGAR archive URL.

## Payment
- Network: **Base mainnet (eip155:8453)**, asset **USDC**
- Payable to: `0x381cdbb664608bf7b1dd4f9403a572c1c57332c2`
- Protocol: [x402](https://x402.org) - agent-friendly HTTP 402 negotiation, pay per call.

## Response format
```json
{
  "generatedAt": "2026-09-10T02:00:00Z",
  "source": "SEC EDGAR",
  "count": 12,
  "filings": [
    {
      "type": "10-Q",
      "title": "ACME CORP (CIK 0001234567)",
      "filingDate": "2026-09-10T01:30:00Z",
      "link": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000001/"
    }
  ]
}
```

## Use cases
- Monitor corporate earnings and regulatory disclosures automatically.
- Detect 8-K material events for news / research / trading pipelines.
- Build agents that watch a portfolio of companies for new filings.

## Try it
Call either endpoint, receive HTTP 402 with payment requirements, pay in USDC via any x402-enabled wallet, and get the JSON payload automatically.

## MCP server (plug into Claude / Cursor / any MCP agent)
Both endpoints are also packaged as MCP tools, so an agent can buy the data mid-conversation with no API key and no signup:
- install: `npx -y agentsapi-sec-filings` (or `npm install -g agentsapi-sec-filings`)
- npm page: `https://www.npmjs.com/package/agentsapi-sec-filings`
- run: `agentsapi-sec-filings` (stdio transport)
- tools: `sec_filings_today` ($0.01), `sec_filings_8k` ($0.005), `sec_filings_service_info` (free)
- config env: `X402_PRIVATE_KEY=0x...` (Base wallet holding USDC)
- client config JSON: `GET https://agentsapi.top/mcp.json`
- install guide: `GET https://agentsapi.top/mcp`