{"uid":"cap_RQvp3YTDD1ikVMfwNGKT3","slug":"gloom-finance-stories-api-4bfc6ca4","name":"Gloom Finance Stories 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/stories?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":[{"scope":"single_ticker","topic":"earnings","topics":["earnings"],"sectors":[],"sentiment":"negative","lastSeenAt":"2026-10-27T22:09:02.207Z","firstSeenAt":"2026-10-27T04:12:00.055Z","primarySource":"investinglive-sitemap","lastPublishedAt":"2026-10-27T22:04:23.000Z","firstPublishedAt":"2026-10-27T04:04:00.000Z"}]}},"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_Jvm5vpX0qHrikDAPERSCs","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":"Retrieves aggregated financial news stories with sentiment, topic, sector, and source metadata for individual tickers or market themes.","exampleAgentPrompt":"Pull the latest financial news stories for AAPL from Gloom — I want to see the topics, sentiment, and which sources are reporting, especially anything earnings-related.","exampleUseCases":[{"title":"Earnings sentiment check before trading","prompt":"What's the current sentiment on earnings news stories for TSLA right now? I want to know if coverage is mostly positive or negative and which sources are picking it up."},{"title":"Portfolio news monitoring for alerts","prompt":"Fetch the latest financial news stories for NVDA from Gloom so I can check if there's anything new in the last few hours — topics, sentiment, and when it was first spotted."},{"title":"Sector news topic research","prompt":"Get me a summary of recent financial stories from Gloom — I want to see what topics and sectors are showing up and whether the sentiment is leaning negative or positive overall."}],"resultDescription":"Returns an array of story objects, each containing: scope (e.g. single_ticker), primary topic, full topics array, relevant sectors, overall sentiment (positive/negative/neutral), the primary source name, and four timestamps indicating when the story was first and last seen, and first and last published.","failureModes":["Invalid or missing properties parameter may return empty results or a 400 error","Payment failure (x402) if USDC payment of $0.12 is not correctly attached","Rate limiting or quota exhaustion returning 429","No stories available for a given ticker or topic returns empty data array","Malformed JSON in request body returns 400"],"whenToPreferThis":"Use this endpoint when you need aggregated, sentiment-tagged financial news stories with source provenance and topic classification — particularly for single-ticker analysis. Prefer it over generic news APIs when you need finance-specific metadata like earnings topics, sector tagging, and first/last-seen timestamps from a terminal-grade aggregator.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:41.503Z","isFirstParty":false,"canonicalSlug":"gloom-finance-stories-api-4bfc6ca4"}