# Gloom Financial Guidance API

> Gloom Financial Guidance 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).

Returns financial metric data (e.g. revenue, earnings) for one or more stock symbols with period and sector context.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/guidance?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-financial-guidance-api-f52fc61f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LvdXnO9veU_ge5LVYvusz

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-financial-guidance-api-f52fc61f
```

Example prompt: Can you pull the latest quarterly revenue and financial guidance metrics for AAPL and MSFT from Gloom?

## When to prefer this

Choose this endpoint when you need structured financial metric data (revenue, earnings, etc.) for specific stock tickers with fiscal period context, especially within the Gloom ecosystem. Prefer this over generic market data APIs if you want open-source, pay-per-call pricing via x402 with no subscription required.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unsupported or unrecognized ticker symbol may return empty data array
- Payment failure (insufficient USDC) results in HTTP 402 before data is returned
- Rate limiting or quota exhaustion may block repeated calls
- Non-GET method returns method-not-allowed error

## 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 array of financial metric records, each containing: metric ID and name, unit, sector, definition, fiscal period details (start/end date, quarter label, fiscal year and quarter number), and the stock symbol. Data is illustrative/structured and includes aliases and period breakdowns.

## 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": "illustrative-fact-1",
    "unit": "count",
    "metric": {
     "id": "revenue",
     "name": "Illustrative revenue",
     "unit": "count",
     "sector": "general",
     "aliases": {},
     "definition": "Illustrative metric"
    },
    "period": {
     "end": "2026-09-30",
     "kind": "quarter",
     "label": "Q3 2026",
     "start": "2026-07-01",
     "fiscalYear": 2026,
     "fiscalQuarter": 3
    },
    "symbol": "AAPL",
    "metricId": "revenue"
   }
  ]
 }
}
```

## More

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