{"uid":"cap_1DYoHVD8af3Is_GLMUxL9","slug":"gloom-equity-screener-ca21b009","name":"Gloom Equity Screener","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/equity-screener?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":["definition"],"properties":{"definition":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"name":null,"sector":"Consumer Defensive","symbol":"COST","currency":"USD","exchange":"NASDAQ","industry":"Discount Stores"}]}},"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__fKm15x_G8RyQJcV8hjl2","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":"Screens and filters equities by sector, industry, exchange, and other criteria, returning matching stock symbols with metadata.","exampleAgentPrompt":"Can you screen for equities in the Consumer Defensive sector listed on NASDAQ and show me which ones are in the Discount Stores industry?","exampleUseCases":[{"title":"Sector-based stock discovery","prompt":"Show me all stocks in the Technology sector listed on NYSE so I can start building a watchlist."},{"title":"Industry-specific equity filtering","prompt":"I'm researching the Discount Stores industry — can you pull a list of equities in that space with their exchange and sector info?"},{"title":"Portfolio idea generation by sector","prompt":"I want to explore Consumer Defensive stocks across all exchanges — screen for equities in that sector and give me the symbols and industries."}],"resultDescription":"Returns an array of equity objects, each containing the stock symbol, company name (if available), sector, industry, exchange, and currency — suitable for building watchlists, sector analysis, or investment research pipelines.","failureModes":["Invalid or malformed screener definition query parameter returns an error","No equities match the given filter criteria, returning an empty data array","Missing required 'definition' query parameter causes a 400 Bad Request","API payment failure (x402 payment not accepted) blocks the request","Rate limiting or quota exceeded returns a 429 error"],"whenToPreferThis":"Prefer this endpoint when you need to discover or filter equities by sector, industry, or exchange using structured screener criteria — especially within the Gloom open-source finance terminal ecosystem. It is well-suited for building investment watchlists, sector analysis, or feeding downstream portfolio tools. It charges a small per-call fee via x402/USDC, making it appropriate for on-demand, agent-driven queries rather than high-frequency bulk screening.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:49:58.130Z","isFirstParty":false,"canonicalSlug":"gloom-equity-screener-ca21b009"}