{"uid":"cap_aLyLtZgwuNHaJCCzFA8Yv","slug":"gloom-finance-stories-facets-5f6f6d35","name":"Gloom Finance Stories Facets","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/stories/facets?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"feeds":[{"id":"latest","label":"News Feed"}],"topics":[{"id":"earnings","count":0,"label":"Earnings"}],"sectors":[{"id":"communication_services","count":0,"label":"Communication Services"}],"sources":[{"id":"sec-8k","count":4,"label":"SEC"}]}}},"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_y8D2mDrD0yc0UGfqJwwRy","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 available facets (feeds, topics, sectors, and sources) for filtering financial news stories in the Gloom finance terminal","exampleAgentPrompt":"What financial news feeds, topics, sectors, and sources are available on Gloom right now so I can set up my news filters?","exampleUseCases":[{"title":"Discover available earnings news categories","prompt":"Show me all the earnings-related topics and sectors I can filter financial news by in Gloom — I want to know what's available before setting up my feed."},{"title":"Find SEC filing news sources","prompt":"What news sources does Gloom have available, especially anything related to SEC filings like 8-Ks, so I can focus my research feed on regulatory disclosures?"},{"title":"Explore sector-based news filtering","prompt":"List all the financial sectors I can filter news by in Gloom — I'm trying to set up a communication services and technology-focused news dashboard."}],"resultDescription":"A JSON object containing arrays of available feeds (e.g. 'latest' news feed), topics (e.g. earnings with article counts), sectors (e.g. communication services with counts), and sources (e.g. SEC with counts) — allowing downstream filtering of financial news stories.","failureModes":["Empty counts on topics/sectors if no recent stories match","Missing or malformed properties parameter returns default facets","Rate limiting or payment failure (402) if USDC payment not attached","Service unavailable if Gloom backend is down"],"whenToPreferThis":"Use this endpoint when you need to discover what filtering dimensions are available before querying financial news stories — especially for building dynamic filter UIs, enumerating available sectors/topics, or confirming whether specific news sources like SEC filings are active. Prefer this over direct story queries when you don't yet know what facet values to use.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:43.057Z","isFirstParty":false,"canonicalSlug":"gloom-finance-stories-facets-5f6f6d35"}