{"uid":"cap_4jcktdwec8CuQCBezngGn","slug":"aiworker-data-news-search-9ea2aef3","name":"aiworker-data News Search","description":"Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1","url":"https://aiworker.duckdns.org/v1/news/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"integer","default":48,"maximum":168,"minimum":1,"description":"Only headlines published within the last N hours (default 48)."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Maximum headlines to return (default 20)."},"query":{"type":"string","maxLength":120,"minLength":2,"description":"Search words, matched whole-word and case-insensitively against headline titles and summaries."}}},"responseSchema":{"type":"json","example":{"feeds":{"fresh":11,"stale":1,"total":12},"items":[{"link":"https://www.coindesk.com/markets/2026/09/10/bitcoin-etf-inflows","title":"Bitcoin ETF inflows hit a monthly high","summary":"Spot bitcoin ETFs took in … on Wednesday, the largest daily figure since …","published":"2026-09-10T14:02:00.000Z","publisher":"CoinDesk"}],"query":"bitcoin etf","disclaimer":"…","attribution":"…","generated_at":"2026-09-11T00:00:00.000Z","window_hours":48}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GsdzpuDTLO3aBC94xZmZ7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search recent crypto and finance news headlines by keyword, filtered to a configurable time window, returning titles, summaries, links, and publisher info.","exampleAgentPrompt":"Search for news headlines mentioning 'Base ETF' published in the last 24 hours and show me the top 10 results with summaries and links.","exampleUseCases":[{"title":"Pre-trade news check on a token","prompt":"Before I buy some BRETT, pull the latest 15 headlines mentioning 'BRETT' from the past 48 hours so I can see if there's anything bullish or bearish in the news right now."},{"title":"Monitoring a DeFi protocol's press","prompt":"I want to keep tabs on Aerodrome — can you search for any news about it published in the last 72 hours and give me a summary of what's being reported?"},{"title":"Regulatory news sweep for a brief","prompt":"Search for headlines about 'SEC crypto enforcement' from the last week — give me up to 30 results with publisher names and links so I can compile a briefing."}],"resultDescription":"Returns a JSON object containing: a list of news items (each with title, summary, link, publisher, and ISO timestamp), total count of fresh vs stale feed entries, the echoed query string, the time window used, a generated_at timestamp, and disclaimer/attribution strings.","failureModes":["Query string too short (< 2 chars) or too long (> 120 chars) returns validation error","Hours value outside 1–168 range returns validation error","Limit value outside 1–50 range returns validation error","No matching headlines returns empty items array with feed stats","Payment not included or insufficient USDC causes 402 rejection","Upstream news feed unavailable may return stale or reduced result set"],"whenToPreferThis":"Use this endpoint when you need keyword-searchable, time-windowed crypto and finance news headlines with per-item summaries and source attribution, paid per call in USDC. Prefer it over generic web search when you need structured, machine-readable news data with freshness metadata and no scraping overhead, especially within the aiworker-data ecosystem where the same session may also call DeFi yield, token, or Polymarket routes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:10.460Z","isFirstParty":false}