# Crypto News Headlines Search

> Crypto News Headlines Search is a paid API for AI agents from crypto.openverbs.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns live, ranked crypto news headlines from Google News for a given query, localised by language and location.

## Facts

- Endpoint: POST https://crypto.openverbs.com/v1/news
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-news-headlines-search-c05989b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EvAVpdQJwfDt8gTEYcj59

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability crypto-news-headlines-search-c05989b9 -d '<json body>'
```

Example prompt: Can you pull up the latest Google News headlines about 'bitcoin ETF' right now — top 5 results in English for the United States?

## When to prefer this

Choose this endpoint when you need live, real-time crypto news headlines for a specific topic or coin, especially when localisation by language or country matters. Prefer it over generic web search when you want structured article metadata (title, URL, source, publish time) specifically from Google News in the crypto domain. Use the sibling web-buzz endpoint if you need mention counts or emotional sentiment rather than full articles.

## Known failure modes

- Empty results if query is too niche or misspelled
- Invalid language code returns an error or defaults to English
- Query string exceeding 300 characters is rejected
- Google News rate limits or outages cause upstream failures
- Location name not recognised may default to United States

## How this service works

Live crypto news headlines for a query (e.g. "bitcoin etf", "ethereum upgrade", "solana"), from Google News and localised by location/language. Returns ranked articles with title, URL, domain and, where available, source and publish time.

## Output

A ranked list of up to 10 news articles, each containing the article title, URL, source domain, news outlet name, and publish timestamp (where available), sourced from Google News and filtered by the given query, language, and location.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "minLength": 1,
       "maxLength": 300,
       "description": "Crypto news query, e.g. \"bitcoin etf\" or \"ethereum upgrade\"."
      },
      "location": {
       "type": "string",
       "minLength": 2,
       "maxLength": 120,
       "description": "Location name, e.g. \"United States\". Defaults to United States."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Language code (2-letter). Defaults to en."
      },
      "limit": {
       "type": "integer",
       "minimum": 1,
       "maximum": 10,
       "description": "Maximum articles (1–10). Defaults to 10."
      }
     },
     "required": [
      "q"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 42,
  "results": [
   {
    "url": "https://www.coindesk.com/markets/2026/01/15/bitcoin-etf-inflows-record/",
    "rank": 1,
    "title": "Bitcoin ETFs post record daily inflows as price nears all-time high",
    "domain": "coindesk.com",
    "source": "CoinDesk",
    "timestamp": "2026-01-15 09:30:00 +00:00"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-news-headlines-search-c05989b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.openverbs.com](https://www.zero.xyz/host/crypto.openverbs.com/llms.txt)