# Gloom Risk Factors API

> Gloom Risk Factors API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.06/call, status unknown (last checked 2026-11-01).

Retrieves SEC-filed risk factor disclosures for one or more stock symbols, including filing metadata and risk counts.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/risk-factors?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-risk-factors-api-e7e1d3ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gZZlhwYcvne_S5klh5a8V

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 gloom-risk-factors-api-e7e1d3ae
```

Example prompt: Pull the latest SEC risk factor filings for AAPL and MSFT — I want to see how many risk factors each company disclosed and when their most recent 10-K was filed.

## When to prefer this

Use this endpoint when you need structured, machine-readable SEC risk factor metadata (counts, filing dates, fiscal years) for one or more publicly traded companies, especially when building investment research tools, risk dashboards, or compliance workflows. Prefer this over general financial data APIs when the specific goal is regulatory filing risk disclosure analysis rather than price or earnings data.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty data array
- Missing required 'symbols' query parameter results in a 400 error
- Payment not attached or insufficient USDC results in 402 Payment Required
- Rate limiting or quota exceeded returns 429
- Ticker with no SEC filings on record returns empty results

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of risk factor filing records per symbol, each containing the SEC filing ID, company name, CIK, ticker, date filed, period end date, fiscal year, report year, total risk count, and group count.

## 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": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "0000093410-26-000078",
    "symbol": "AAPL",
    "company": {
     "cik": "0000093410",
     "name": "Chevron Corporation",
     "ticker": "CVX"
    },
    "filedAt": "2026-02-24T00:00:00.000Z",
    "periodEnd": "2025-12-31",
    "riskCount": 3,
    "updatedAt": "2026-10-08T12:00:00.000Z",
    "fiscalYear": 2025,
    "groupCount": 1,
    "reportYear": 2026
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-risk-factors-api-e7e1d3ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)