# TBS SEC Filings API

> TBS SEC Filings API is a paid API for AI agents from sec-x402.tbs-digital.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-01).

Retrieves SEC EDGAR filings (10-K, 10-Q, 8-K) and company metadata by ticker or CIK, returning filing URLs and key financial facts, payable via USDC on Base.

## Facts

- Endpoint: GET https://sec-x402.tbs-digital.com/sec/filings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-sec-filings-api-55e11ef2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_If1Us-1WfuC5NaNT_L35F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tbs-sec-filings-api-55e11ef2
```

Example prompt: Can you pull the last 5 SEC filings for Apple — ticker AAPL — and give me the direct document URLs for any 10-K or 10-Q?

## When to prefer this

Use this endpoint when you need direct SEC EDGAR filing URLs and company metadata by ticker or CIK without managing API keys or complex EDGAR queries. It is ideal for AI agents needing a simple, unified schema for financial document retrieval at sub-cent cost per call, especially in crypto-native workflows using USDC payments on Base.

## Known failure modes

- Unknown ticker or CIK returns empty or error response
- Invalid form type filter silently ignored or returns no results
- Limit parameter out of range (>50 or <1) may cause validation error
- Payment failure on x402 protocol if wallet lacks sufficient USDC
- SEC EDGAR upstream downtime causes stale or missing data
- CIK-only lookup required if ticker is delisted or non-US company

## How this service works

SEC EDGAR data for AI agents in one sub-cent call: resolve a ticker or company name to its CIK, list recent filings (10-K, 10-Q, 8-K) with direct document URLs, and pull XBRL financial facts (revenue, net income, assets, EPS). Keyless, unified schema, USDC-payable via x402 on Base.

## Output

Returns a JSON object with the resolved company name and CIK, a list of filings each containing form type, filing date, accession number, and a direct SEC.gov document URL, plus request metadata including payer address, network, source, and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC CIK, e.g. 320193 (or use ticker)"
      },
      "type": {
       "type": "string",
       "description": "Form type filter, e.g. 10-K (optional)"
      },
      "limit": {
       "type": "string",
       "description": "Max filings 1-50 (default 20)"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker, e.g. AAPL (or use cik)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "source": {
       "type": "string"
      },
      "company": {
       "type": "object"
      },
      "filings": {
       "type": "array"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "payer": {
   "address": "0x0000000000000000000000000000000000000000",
   "network": "base"
  },
  "source": "sec-edgar",
  "company": {
   "cik": "0000320193",
   "name": "Apple Inc."
  },
  "filings": [
   {
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
    "form": "10-K",
    "accession": "0000320193-24-000123",
    "description": "10-K",
    "filing_date": "2024-11-01",
    "primary_doc": "aapl-20240928.htm"
   }
  ],
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "generated_at": "2026-08-11T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-sec-filings-api-55e11ef2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sec-x402.tbs-digital.com](https://www.zero.xyz/host/sec-x402.tbs-digital.com/llms.txt)