{"uid":"cap_-sDXwOCNEaIUq5YWlawrp","slug":"agentutility-crypto-news-with-sentiment-e8c013ca","name":"AgentUtility Crypto News with Sentiment","description":"Fetches recent cryptocurrency news headlines from GDELT with a GNews fallback when configured, filtered by crypto topic or caller query, returning headline URLs, domains, timestamps, language/country metadata, and headline sentiment. Not trading advice. Use it as a crypto news API or market news feed for bitcoin news, ethereum news, DeFi news, or stablecoin news.","url":"https://x402.agentutility.ai/crypto-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, max 240 chars."},"topic":{"enum":["crypto","markets","defi","bitcoin","ethereum","stablecoins"],"type":"string","description":"Preset topic. Default crypto."}}},"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"},"articles":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"domain":{"type":"string"},"sentiment":{"type":"object","properties":{"label":{"type":"string"},"score":{"type":"number"}}}}}},"returned":{"type":"integer"},"sentiment":{"type":"object","properties":{"distribution":{"type":"object","properties":{"neutral":{"type":"integer"},"negative":{"type":"integer"},"positive":{"type":"integer"}}},"average_score":{"type":"number"}}}}}}}}},"responseSchema":{"type":"json","example":{"topic":"crypto","source":"GDELT 2.1 Document API","articles":[{"title":"Bitcoin rally sets record","domain":"example.com","sentiment":{"label":"positive","score":0.667}}],"returned":10,"sentiment":{"distribution":{"neutral":6,"negative":1,"positive":3},"average_score":0.1}}},"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_eVJZPYJSQwAcDYcqllXdB","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 cryptocurrency news articles from GDELT 2.1 with per-article and aggregate sentiment analysis","exampleAgentPrompt":"Pull the latest crypto news articles and tell me how they're trending sentiment-wise — are they mostly positive, negative, or neutral overall?","exampleUseCases":null,"resultDescription":"A JSON object containing the topic queried, the source (GDELT 2.1 Document API), an array of articles (each with title, domain, and sentiment label and score), the count of articles returned, and an aggregate sentiment distribution (neutral/negative/positive counts) along with an average sentiment score across all articles.","failureModes":["Payment not included or invalid x402 USDC payment → 402 Payment Required","GDELT API unavailable or rate-limited upstream → 503 or timeout","No articles found for topic in recent GDELT index → empty articles array","Malformed request body → 400 Bad Request"],"whenToPreferThis":"Choose this endpoint when you need a quick, pay-per-call snapshot of recent crypto news headlines paired with sentiment scores — especially useful for agents that need to gauge market mood or narrative direction without subscribing to a dedicated news API. Prefer over general search APIs when crypto-specific sentiment distribution is required in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:09:20.965Z","isFirstParty":false}