agentutility(7)$ man news-api
/news-api
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
news-api — news api for agents that need recent public articles by keyword, company, ticker, market topic, or crypto topic
synonym alias of crypto-news — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/news-api
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
News API for agents that need recent public articles by keyword, company, ticker, market topic, or crypto topic. Uses the same GDELT search and configured GNews fallback as news-search, returning headline URLs, source domains, timestamps, language and country metadata, and sentiment. Use it as a general news API, article search endpoint, or public news feed lookup. Data only; no trading advice.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| topic | string | Preset topic. Default crypto. enum: crypto · markets · defi · bitcoin · ethereum · stablecoins | optional |
| query | string | Optional news query override, max 240 chars. | optional |
| limit | number | Headlines to return, 1-30. Default 10. | optional |
| hours | number | Lookback window in hours, 1-168. Default 48. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| query | string | — |
| returned | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/news-api \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the news-api tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probenewsapinews-api
- methods
- POST
- cluster
- webprobe
- price
- $0.005 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| arxiv-bibtex | Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma… | $0.005 |
| brand-domain-check | Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who… | $0.005 |
| brand-name-score | Scores a candidate brand or startup name on quality and risk. | $0.005 |
| brand-watch-domain-risk | Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses. | $0.005 |
| company-name-score | Scores the quality of a company name before you commit to domain, handle, trademark, and launch work. | $0.005 |
| creator-domain-check | Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags. | $0.005 |
| crypto-headlines | Crypto headlines API for agents that need breaking cryptocurrency news by topic or query. | $0.005 |
| crypto-news | Crypto news API that searches recent cryptocurrency headlines for a topic, token, protocol, or market event. | $0.005 |
SEE ALSO