{"uid":"cap_4QIe--s1nCOKtB9tUzQ-O","slug":"agentutility-stocks-news-api-b4ee7aae","name":"AgentUtility Stocks News API","description":"Fetches recent stock market news on equities, earnings, IPOs, the Fed, and macro from GDELT with a GNews fallback when configured, returning headline metadata with sentiment and source domains. The equities companion to crypto-news. Data-only news digests; no price prediction, trading advice, or order routing. Use it as a stocks news API, equities news feed, earnings news source, or Wall Street headlines for agents.","url":"https://x402.agentutility.ai/stocks-news","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{"hours":{"type":"number","description":"Lookback window in hours, 1-168. Default 48."},"limit":{"type":"number","description":"Headlines to return, 1-30. Default 10."},"query":{"type":"string","description":"Optional news query override (e.g. a ticker or company), max 240 chars."},"topic":{"enum":["stocks","earnings","ipos","fed","macro","tech"],"type":"string","description":"Preset topic. Default stocks."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"topic":{"type":"string"},"source":{"type":"string"},"returned":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"topic":"earnings","source":"GDELT 2.1 Document API","returned":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WwpGejRn-gED2vXMK6zvS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches recent stock market news headlines on equities, earnings, IPOs, Fed policy, and macro topics from GDELT with GNews fallback, returning headline metadata with sentiment and source domains.","exampleAgentPrompt":"Pull the latest 10 earnings news headlines from the stocks news feed, including sentiment and source info — I want to see what's moving markets around earnings season right now.","exampleUseCases":[{"title":"Earnings season news briefing","prompt":"Get me the top 10 earnings news headlines right now with sentiment scores — I want to see which companies are beating or missing estimates this quarter."},{"title":"IPO market monitoring","prompt":"Fetch the latest IPO news headlines from the equities news feed so I can see what new listings are in the pipeline and how the market is reacting."},{"title":"Fed policy impact digest","prompt":"Pull recent Fed and macro news headlines for me — I need to understand what the latest central bank signals are and how the market is interpreting them."}],"resultDescription":"A JSON object containing the topic queried, the data source used (GDELT 2.1 or GNews), and an array of headline metadata records including article titles, publication timestamps, sentiment scores, and source domain names, with a count of results returned.","failureModes":["GDELT API unavailable and GNews fallback not configured — returns empty or error response","Topic parameter not recognized — may return irrelevant or zero results","Rate limiting or x402 payment failure — request rejected with payment required error","Stale data if GDELT indexing is delayed — headlines may lag by minutes to hours"],"whenToPreferThis":"Choose this endpoint when an agent needs a structured, low-cost news digest specifically for equities, earnings, IPOs, Fed policy, or macro topics with sentiment metadata attached. It is the stock market analog to a crypto news feed, optimized for financial agent workflows that need headline-level awareness rather than price data or trading signals. Prefer it over general web search when you want structured JSON with sentiment and source provenance already computed, and when you want GDELT's broad media coverage with a fallback source.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:03:31.072Z","isFirstParty":false}