# Hermes SEC Company Snapshot

> Hermes SEC Company Snapshot is a paid API for AI agents from hermes-counterparty-api.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a structured snapshot of a US public company from SEC EDGAR, including company metadata, financial facts, and recent filing references, resolved by ticker or CIK.

## Facts

- Endpoint: POST https://hermes-counterparty-api.onrender.com/v1/sec-company-snapshot
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-sec-company-snapshot-dee745e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tN2QmCYC_t0RQq8PL5D3o

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 hermes-sec-company-snapshot-dee745e2 -d '<json body>'
```

Example prompt: Pull the SEC EDGAR snapshot for Apple — ticker AAPL — and give me their latest 10-K and 10-Q filing info plus whatever financial facts are available like revenue and shares outstanding.

## When to prefer this

Use this endpoint when you need authoritative, regulator-sourced data about a US public company — specifically SEC registration metadata, SIC classification, exchange listing, and references to official filings (10-K, 10-Q, 8-K). Prefer this over commercial data providers when regulatory accuracy and official filing traceability matter, such as for compliance, due diligence, or counterparty verification workflows. It accepts either a ticker symbol or a CIK, making it flexible for both human-facing and programmatic inputs.

## Known failure modes

- Unknown ticker or CIK returns empty or unresolved company object
- Financial facts fields may all be null if EDGAR XBRL data is unavailable or not parsed
- Latest filing references (10-K, 10-Q, 8-K) may be null for newly listed or non-reporting companies
- Invalid CIK format (more than 10 digits) rejected at input validation
- Rate limiting or Render.com cold-start latency may cause timeouts on first request
- Non-US or OTC companies not registered with SEC will not resolve

## How this service works

Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.

## Output

A JSON object containing: resolved CIK, company name, ticker, exchange, SIC code; financial facts (assets, revenue, net income, liabilities, shares outstanding — may be null if not parsed); references to latest 8-K, 10-K, and 10-Q filings; data source attribution (SEC EDGAR); schema version; and any warnings encountered during resolution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": [
    "string",
    "integer"
   ],
   "description": "SEC Central Index Key, 1 to 10 digits"
  },
  "ticker": {
   "type": "string",
   "maxLength": 20,
   "minLength": 1,
   "description": "US public-company ticker, for example AAPL"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "facts": {
   "assets": null,
   "revenue": null,
   "net_income": null,
   "liabilities": null,
   "shares_outstanding": null
  },
  "query": {
   "cik": null,
   "ticker": "AAPL",
   "resolved_cik": "0000320193"
  },
  "source": {
   "provider": "SEC EDGAR"
  },
  "company": {
   "cik": "0000320193",
   "sic": "3571",
   "name": "Apple Inc.",
   "ticker": "AAPL",
   "exchange": "Nasdaq"
  },
  "filings": {
   "latest_8_k": null,
   "latest_10_k": null,
   "latest_10_q": null
  },
  "warnings": [],
  "schema_version": "1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-sec-company-snapshot-dee745e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermes-counterparty-api.onrender.com](https://www.zero.xyz/host/hermes-counterparty-api.onrender.com/llms.txt)