# Gloom Finance Stories API

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

Retrieves aggregated financial news stories with sentiment, topic, sector, and source metadata for individual tickers or market themes.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/stories?utm_source=zero.xyz
- Price: $0.12/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-api-4bfc6ca4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RQvp3YTDD1ikVMfwNGKT3

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-api-4bfc6ca4
```

Example prompt: Pull the latest financial news stories for AAPL from Gloom — I want to see the topics, sentiment, and which sources are reporting, especially anything earnings-related.

## When to prefer this

Use this endpoint when you need aggregated, sentiment-tagged financial news stories with source provenance and topic classification — particularly for single-ticker analysis. Prefer it over generic news APIs when you need finance-specific metadata like earnings topics, sector tagging, and first/last-seen timestamps from a terminal-grade aggregator.

## Known failure modes

- Invalid or missing properties parameter may return empty results or a 400 error
- Payment failure (x402) if USDC payment of $0.12 is not correctly attached
- Rate limiting or quota exhaustion returning 429
- No stories available for a given ticker or topic returns empty data array
- Malformed JSON in request body returns 400

## 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 story objects, each containing: scope (e.g. single_ticker), primary topic, full topics array, relevant sectors, overall sentiment (positive/negative/neutral), the primary source name, and four timestamps indicating when the story was first and last seen, and first and last published.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "scope": "single_ticker",
    "topic": "earnings",
    "topics": [
     "earnings"
    ],
    "sectors": [],
    "sentiment": "negative",
    "lastSeenAt": "2026-10-27T22:09:02.207Z",
    "firstSeenAt": "2026-10-27T04:12:00.055Z",
    "primarySource": "investinglive-sitemap",
    "lastPublishedAt": "2026-10-27T22:04:23.000Z",
    "firstPublishedAt": "2026-10-27T04:04:00.000Z"
   }
  ]
 }
}
```

## More

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