{"uid":"cap_LvdXnO9veU_ge5LVYvusz","slug":"gloom-financial-guidance-api-f52fc61f","name":"Gloom Financial Guidance API","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/guidance?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":[{"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"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8gYmdX-ydxCPy4zXFloYc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns financial metric data (e.g. revenue, earnings) for one or more stock symbols with period and sector context.","exampleAgentPrompt":"Can you pull the latest quarterly revenue and financial guidance metrics for AAPL and MSFT from Gloom?","exampleUseCases":[{"title":"Quarterly earnings research for portfolio","prompt":"Fetch the latest quarterly financial metrics for my portfolio stocks — AAPL, TSLA, and NVDA — so I can see their revenue figures for the most recent fiscal quarter."},{"title":"Sector comparison of financial metrics","prompt":"I want to compare revenue metrics across Apple, Google, and Microsoft for Q3 2026 — can you pull that financial guidance data for all three symbols?"},{"title":"Stock screening by financial metric","prompt":"Get me the revenue and key financial metrics for Amazon (AMZN) for the current fiscal year so I can evaluate whether it's worth adding to my watchlist."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:42.456Z","isFirstParty":false,"canonicalSlug":"gloom-financial-guidance-api-f52fc61f"}