{"uid":"cap_KF5U5UCmPSKnKE4YB6hSa","slug":"gloom-analyst-estimates-revisions-ae12c16c","name":"Gloom Analyst Estimates Revisions","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/analyst-estimates/revisions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qzw33i0TF0tNcLRZN4MtU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns analyst EPS estimate revisions for one or more stock symbols, including high, low, and average consensus figures by period.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-earnings consensus check","prompt":"Pull the latest analyst EPS estimates for NVDA before their earnings report — I want to see the high, low, and average consensus and how many analysts are weighing in this quarter."},{"title":"Multi-stock portfolio earnings scan","prompt":"Get the current quarter analyst EPS estimate revisions for AAPL, MSFT, and GOOGL so I can compare consensus expectations across my tech holdings."},{"title":"Estimate revision monitoring for a single name","prompt":"Has the analyst EPS consensus for TSLA shifted recently? Show me the current high, low, and average estimates for this quarter and when they were last recorded."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:56:16.424Z","isFirstParty":false,"canonicalSlug":"gloom-analyst-estimates-revisions-ae12c16c"}