# Gloom Analyst Estimates Revisions

> Gloom Analyst Estimates Revisions 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 analyst EPS estimate revisions for one or more stock symbols, including high, low, and average consensus figures by period.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/analyst-estimates/revisions?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-analyst-estimates-revisions-ae12c16c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KF5U5UCmPSKnKE4YB6hSa

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-analyst-estimates-revisions-ae12c16c
```

Example prompt: What are the current analyst EPS estimate revisions for AAPL — give me the high, low, and average consensus along with how many analysts are covering it this quarter?

## When to prefer this

Use this endpoint when you need structured analyst EPS consensus data — including high, low, and average estimates plus analyst count — for one or more equities by period. It is preferable to general financial news endpoints when you specifically need numerical earnings estimate figures and revision metadata rather than qualitative commentary. Best suited for screening, comparison, or pre-earnings research workflows.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty data array
- Missing required 'symbols' query parameter returns a 400 error
- Payment not provided or insufficient USDC balance triggers 402 Payment Required
- Rate limiting may occur if many symbols are requested simultaneously
- Data may lag real-time analyst updates by hours depending on feed refresh

## 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 a JSON array where each element contains the stock symbol, current period label (e.g. 'current quarter'), period end date, EPS high/low/average estimates, number of analysts, currency, and the date the estimates were observed and recorded. Example: AAPL current quarter EPS average ~$1.98, range $1.93–$2.07 from 27 analysts.

## 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": [
   {
    "epsLow": 1.93,
    "period": "current quarter",
    "symbol": "AAPL",
    "epsHigh": 2.07,
    "analysts": 27,
    "currency": "USD",
    "periodEnd": "2026-09-30",
    "epsAverage": 1.97865,
    "observedOn": "2026-10-08",
    "recordedAt": "2026-10-08T17:00:18.118Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-analyst-estimates-revisions-ae12c16c/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)