# Gloom Finance Stories Facets

> Gloom Finance Stories Facets 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).

Returns available facets (feeds, topics, sectors, and sources) for filtering financial news stories in the Gloom finance terminal

## Facts

- Endpoint: GET https://api.gloom.sh/v1/stories/facets?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-finance-stories-facets-5f6f6d35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aLyLtZgwuNHaJCCzFA8Yv

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-finance-stories-facets-5f6f6d35
```

Example prompt: What financial news feeds, topics, sectors, and sources are available on Gloom right now so I can set up my news filters?

## When to prefer this

Use this endpoint when you need to discover what filtering dimensions are available before querying financial news stories — especially for building dynamic filter UIs, enumerating available sectors/topics, or confirming whether specific news sources like SEC filings are active. Prefer this over direct story queries when you don't yet know what facet values to use.

## Known failure modes

- Empty counts on topics/sectors if no recent stories match
- Missing or malformed properties parameter returns default facets
- Rate limiting or payment failure (402) if USDC payment not attached
- Service unavailable if Gloom backend is down

## 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

A JSON object containing arrays of available feeds (e.g. 'latest' news feed), topics (e.g. earnings with article counts), sectors (e.g. communication services with counts), and sources (e.g. SEC with counts) — allowing downstream filtering of financial news stories.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "feeds": [
    {
     "id": "latest",
     "label": "News Feed"
    }
   ],
   "topics": [
    {
     "id": "earnings",
     "count": 0,
     "label": "Earnings"
    }
   ],
   "sectors": [
    {
     "id": "communication_services",
     "count": 0,
     "label": "Communication Services"
    }
   ],
   "sources": [
    {
     "id": "sec-8k",
     "count": 4,
     "label": "SEC"
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-finance-stories-facets-5f6f6d35/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)