{"uid":"cap_UOZekoMvablZajMo_aBrx","slug":"agentutility-crypto-headlines-af4c7a10","name":"AgentUtility Crypto Headlines","description":"Searches recent bitcoin, ethereum, and DeFi headlines via GDELT with a GNews fallback when configured, returning headline URLs, domains, timestamps, language/country metadata, and headline sentiment. Not trading advice. Use it as a crypto headlines API or low-cost cryptocurrency news feed.","url":"https://x402.agentutility.ai/crypto-headlines","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"},"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","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":"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.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_SXmbWFy8nDZ0Z1_mHXBdO","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":"Searches and returns recent Bitcoin, Ethereum, and DeFi news headlines with URLs, domains, timestamps, language/country metadata, and sentiment scores via GDELT with GNews fallback.","exampleAgentPrompt":"Fetch me the latest Bitcoin, Ethereum, and DeFi headlines right now — I want the article URLs, which sites they came from, when they were published, and whether the sentiment is bullish or bearish.","exampleUseCases":[{"title":"Daily crypto briefing for a trading bot","prompt":"Pull today's top Bitcoin and Ethereum headlines with their sentiment scores so I can see whether the news mood is bullish or bearish before my agent makes any decisions."},{"title":"DeFi news monitoring for a research agent","prompt":"Get me the most recent DeFi headlines from the last few hours, including the source domain and publication timestamp, so I can track what's happening in decentralized finance right now."},{"title":"Crypto sentiment dashboard feed","prompt":"Search for recent cryptocurrency news headlines across Bitcoin, Ethereum, and DeFi and return the sentiment for each one — I want to build a live sentiment tracker for my dashboard."}],"resultDescription":"Returns a list of recent crypto news headlines, each with: article URL, source domain, publication timestamp, detected language, country of origin, and a sentiment score for the headline. Results come from GDELT with a GNews fallback. Not trading advice.","failureModes":["GDELT API unavailable and GNews not configured — returns empty or error response","No recent headlines found for the queried topic — empty results list","Rate limiting or payment failure via x402 — 402 payment required error","Malformed POST body — 400 bad request","GNews API key missing when GDELT has no results — partial or no fallback results"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call crypto news feed with sentiment metadata and source provenance, especially in autonomous agent pipelines that settle payments in USDC on Base. Prefer it over full RSS scrapers or expensive news APIs when you only need crypto-specific headlines (BTC, ETH, DeFi) and want structured metadata including language, country, and sentiment without building your own aggregation pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:56:42.097Z","isFirstParty":false}