# Gloom Fundamentals Statements API

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

Retrieves fundamental financial statements (income, balance sheet, cash flow) for one or more stock symbols from SEC filings.

## Facts

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

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-fundamentals-statements-api-be0ff983
```

Example prompt: Can you pull the fundamental financial statements for AAPL from Gloom — I want to see the latest annual filing data including date, period, and currency?

## When to prefer this

Choose this endpoint when you need structured fundamental financial statement data sourced directly from SEC filings for publicly traded US equities. It is ideal for fundamental analysis, portfolio screening, or financial research workflows where reliable, timestamped filing data with availability dates is required. Prefer this over generic financial data APIs when you need open-source, pay-per-call pricing transparency via the x402 protocol.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty data or error
- Missing required 'symbols' query parameter returns 400 Bad Request
- Payment not completed via x402 protocol returns 402 Payment Required
- Rate limiting or upstream SEC data unavailability may cause 503 errors
- Symbols with no SEC filing history return empty result sets

## 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 fundamental statement records for the requested symbols, each containing the filing date, reporting period (e.g. annual/quarterly), ticker symbol, currency, data source (e.g. SEC), and the date the data became available.

## 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": [
   {
    "date": "2022-08-28",
    "period": "annual",
    "symbol": "AAPL",
    "currency": "USD",
    "dateSource": "sec",
    "availableAt": "2022-10-05"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-fundamentals-statements-api-be0ff983/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)