# TrollBridge SEC Facts

> TrollBridge SEC Facts is a paid API for AI agents from mini-tollbooth.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Retrieves official SEC EDGAR company financial facts (revenue, net income, assets, EPS) for any US-listed stock ticker, with 5 annual and 4 quarterly periods.

## Facts

- Endpoint: GET https://mini-tollbooth.onrender.com/sec-facts?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trollbridge-sec-facts-c2a9eb42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XdMNc9NZ5GBbnxdxJcg_T

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 trollbridge-sec-facts-c2a9eb42
```

Example prompt: Pull the official SEC EDGAR financial facts for AAPL — I want their revenue, net income, assets, and EPS for the last several annual and quarterly periods, no estimates.

## When to prefer this

Choose this endpoint when you need authoritative, unestimated financial facts for US-listed companies directly from SEC EDGAR — ideal when accuracy and regulatory sourcing matter more than speed or breadth. Prefer it over financial data aggregators when you need to avoid hallucinated or estimated figures, or when you need to cite an official regulatory source. Best for fundamental analysis, compliance research, or fact-checking financial news.

## Known failure modes

- Unknown or invalid ticker symbol returns an error or empty result
- Ticker not found in SEC company tickers list causes a lookup failure
- Non-US-listed companies are not supported and will fail
- Rate limiting or payment failure at the x402 micropayment layer
- SEC EDGAR API downtime causes upstream fetch failure
- Very recently listed companies may have incomplete or missing EDGAR data

## How this service works

The insurance booth for AI agents, with Mini's Agent Supply Store on the side of the road. One hundred checkpoints: pre-transaction safety lanes (honeypot, approval-risk, rug-score, receipt-check, tx-dryrun, permit-scan, airdrop-verdict, deployer-history, wallet-watch, secret-scan at $0.02 USDC per call; the protection tier — /contract-check, /approval-screen, /tx-plain-english, /honeypot-check, /tx-simulate, /redteam, /skill-scan, /verdict, /egress-audit, /tool-gate, /airlock, /repo-scan, /prove, /task-scope — at $0.10; the one-call /shield don't-get-rugged screen at $0.25; the full /preflight bundle at $0.05), bounty intel (bounties, fresh, verdicts, deadlines, sweepstakes, opportunities) at $0.02 USDC per call, trader intel (/prices and /quant at $0.02; /enrich and /token-check at $0.05; /contract-check and /honeypot-check at $0.10; /sec-facts at $0.05), market intel (/markets and /search at $0.05; /grants at $0.02), DeFi intel (/yields and /new-pairs at $0.05; /gas and /defi at $0.02), AI intel (/models at $0.02), agent-ops intel (/prompt-cost, /model-picks, /rpc-speed, /terms-tldr, /scrape, /gigs, /retry-verify, /idempotency, /verify-independent at $0.02; /site-watch, /wallet-check, /code-run, /regulatory-pack, /sage, /cron-watch, /caveat-check, /tripwire, /escrow, /trust, /bridge-fees, /dao-votes, /dev-activity, /dex-arb, /dydx-perps, /funding-rates, /gas-predict, /hack-tracker, /long-short-ratio, /lp-yields, /mev-scan, /open-interest, /perp-basis, /polymarket-odds, /rwa-watch, /sentiment, /stablecoin-flows, /tokenomics, /top-movers, /whale-watch, and /yield-stable at $0.05; /approval-screen, /tx-plain-english, /tx-simulate, and /task-scope at $0.10; /scam-scan deep scan at $5.00 or 30-day subscription at $30.00), supply store (/road-pack combo meal at $0.05; curated datasets, the /audit-prep pre-audit review, and the /prove-state symbolic-execution run at $1.00; the /audit AI-agent audit at $25.00). Every lane answers before money moves — heuristic verdicts, not audits. Don't get rugged.

## Output

A JSON object containing the company's CIK, ticker, company name, and an array of financial facts (such as total revenue, net income, total assets, and EPS) each with annual values for up to 5 periods and quarterly values for up to 4 periods, sourced directly from SEC EDGAR companyfacts with no estimates or interpolations.

## 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",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "US stock ticker (e.g. AAPL) — resolved via the SEC company tickers list, facts from SEC EDGAR companyfacts."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "lane": "/sec-facts",
  "facts": [
   {
    "label": "Total revenue",
    "annual": [
     {
      "end": "2025-09-27",
      "val": 416161000000
     }
    ]
   }
  ],
  "source": "SEC EDGAR companyfacts",
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "description": "Company facts from the source ($0.05) — revenue, net income, assets, and EPS for any US-listed ticker, 5 annual + 4 quarterly periods, straight from SEC EDGAR companyfacts. No estimates, no hallucination."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trollbridge-sec-facts-c2a9eb42/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mini-tollbooth.onrender.com](https://www.zero.xyz/host/mini-tollbooth.onrender.com/llms.txt)
