{"uid":"cap_u_8T4Cu1Onl3WXsKNwXWA","slug":"stock-news-equities-headlines-stock-news-c06becbe","name":"Stock News & Equities Headlines (stock-news)","description":"Stock news / equities headlines (alias of stocks-news). GDELT-backed public news with a GNews fallback when configured on stocks, earnings, IPOs, the Fed, and macro with sentiment. Buyer-wording variant of stocks-news. Data-only; no trading advice.","url":"https://x402.agentutility.ai/stock-news?utm_source=zero.xyz","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, 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":"stocks","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_SK6FcSvrgPMIn-sq0vp2v","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":"Returns sentiment-tagged financial news headlines on stocks, earnings, IPOs, the Fed, and macro topics, sourced from GDELT with GNews fallback.","exampleAgentPrompt":"Pull the top 10 stock market headlines from the last 48 hours using the stocks topic, and include sentiment — I want to see what's moving the market right now.","exampleUseCases":[{"title":"Pre-market briefing for a trader","prompt":"Give me the 15 most recent earnings headlines from the last 24 hours so I can prep for today's trading session."},{"title":"IPO watch for an investment researcher","prompt":"Fetch the top 10 IPO news stories from the past 72 hours — I'm tracking upcoming public offerings for a research report."},{"title":"Fed policy monitoring for a macro analyst","prompt":"Get me the latest 10 Fed-related headlines from the past week — I need to see what the market is saying about interest rate expectations."}],"resultDescription":"A JSON object containing the topic queried, the data source used (GDELT or GNews), the number of headlines returned, and an array of news headlines with associated sentiment data for the specified financial topic and time window.","failureModes":["Invalid topic enum value returns a validation error","Hours outside 1-168 range rejected","Query string exceeding 240 characters truncated or rejected","GNews fallback may return fewer results if GDELT data is sparse","Payment failure (insufficient USDC) returns 402 before processing","Limit values outside 1-30 range rejected"],"whenToPreferThis":"Choose this endpoint when you need fast, structured financial news headlines with sentiment covering stocks, earnings, IPOs, the Fed, or macro topics — especially when you want GDELT's broad public news corpus with a GNews fallback safety net, at a very low per-call cost of $0.005 USDC. Prefer it over generic news APIs when your use case is specifically financial/equities-focused and you need preset topic filtering without building your own query logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T00:41:32.452Z","isFirstParty":false,"canonicalSlug":"stock-news-equities-headlines-stock-news-c06becbe"}