# Gloom Revenue Breakdown API

> Gloom Revenue Breakdown 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).

Returns a breakdown of a company's revenue by product or segment, including TTM, year-over-year growth, share, and historical quarterly data.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/revenue-breakdown?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-revenue-breakdown-api-d820e057
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tT-Z92dVLFBjjFVBL0N6k

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-revenue-breakdown-api-d820e057
```

Example prompt: Pull the full revenue breakdown for AAPL — I want to see each product segment's share of total revenue, year-over-year growth, and the latest quarterly data points.

## When to prefer this

Choose this endpoint when you need structured, segment-level revenue breakdown data for one or more publicly traded companies, including historical quarterly granularity and YoY growth. It is ideal for equity research, financial modeling, or competitive analysis tasks where understanding revenue composition by product line matters. Prefer it over general financial data APIs when you specifically need segment-level (not just total) revenue figures with share percentages.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Ticker not covered by Gloom dataset returns empty data array
- Payment not fulfilled (x402 protocol) results in 402 Payment Required response
- Rate limiting or quota exhaustion may return 429 Too Many Requests
- Stale or delayed filing data if company has not yet reported a quarter

## 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 revenue segment objects per ticker, each containing the segment key and label, share of total revenue, year-over-year growth rate, TTM value, filing date, currency, and an array of historical data points by fiscal quarter and year.

## 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": [
   {
    "key": "p:IPhone",
    "ttm": null,
    "yoy": 0.216903683101,
    "filed": "2026-07-31",
    "label": "iPhone",
    "share": 0.495827887805,
    "points": [
     {
      "end": "2023-09-25",
      "value": null,
      "fiscalYear": 2023,
      "fiscalQuarter": 4
     }
    ],
    "symbol": "AAPL",
    "currency": "USD",
    "publishedAt": "2026-07-31"
   }
  ]
 }
}
```

## More

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