# Bitcoin News Headlines Search via GDELT

> Bitcoin News Headlines Search via GDELT is a paid API for AI agents from 4yearcycle.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Fetches deduplicated, recent news headlines matching a GDELT-powered full-text query, with filters for language, time window, and source country.

## Facts

- Endpoint: GET https://4yearcycle.com/x402/news-headlines
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-news-headlines-search-via-gdelt-1cc034c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L6bZ1hoIMRSJY9FWrs98j

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 bitcoin-news-headlines-search-via-gdelt-1cc034c5
```

Example prompt: Search for the latest English-language news headlines about 'Bitcoin ETF outflows' from the past 48 hours, return up to 30 results.

## When to prefer this

Choose this endpoint when you need recent, deduplicated news headlines searchable by full-text GDELT query with language and country filters, especially for Bitcoin or crypto topics. Prefer it over generic web search when you want structured article metadata (URL, domain, language, country, timestamp) rather than ranked snippets, and when you need to filter by publication recency (up to 7 days) or source country.

## Known failure modes

- Empty result set (count: 0) when no articles match the query within the time window
- Query syntax errors if GDELT operators are malformed (e.g. unclosed quotes)
- hours or max values above caps (168, 100) are silently capped rather than errored
- Invalid country codes or language names return no results rather than an error
- Payment failure if USDC balance is insufficient for the $0.01 per-call fee

## How this service works

Interactive Bitcoin 4-year halving cycle chart on a polar disc. Live price, 200W MA, Mayer Multiple, RSI, MACD, Pi Cycle and optional paid cycle projections.

## Output

A JSON object containing a count of returned articles and an array of deduplicated news article objects, each with URL, title, domain, language, first-seen timestamp, and source country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "max": {
       "type": "string",
       "default": "20",
       "pattern": "^\\d{1,3}$",
       "examples": [
        "20",
        "100"
       ],
       "description": "Maximum number of headlines to return after deduplication. Integer 1-100; values above 100 are capped. Default: 20."
      },
      "lang": {
       "type": "string",
       "default": "english",
       "examples": [
        "english",
        "german",
        "any"
       ],
       "description": "Article language filter, GDELT language name (english, german, spanish, ...). Use \"any\" for all 65 languages. Default: english."
      },
      "hours": {
       "type": "string",
       "default": "24",
       "pattern": "^\\d{1,3}$",
       "examples": [
        "24",
        "168"
       ],
       "description": "Look-back window in hours over article first-seen time. Integer 1-168 (7 days); values above 168 are capped. Default: 24."
      },
      "query": {
       "type": "string",
       "examples": [
        "\"bitcoin regulation\"",
        "(drought OR wildfire) climate",
        "semiconductor domain:reuters.com"
       ],
       "description": "Required free-text search over article text, GDELT syntax: quote multi-word phrases (\"bitcoin regulation\"), parenthesized OR groups, domain:site.com. Unquoted multi-word input means all words anywhere in the article."
      },
      "country": {
       "type": "string",
       "examples": [
        "germany",
        "unitedstates",
        "US"
       ],
       "description": "Optional source-country filter on the publishing outlet: GDELT country name without spaces (germany, france, unitedstates) or FIPS 2-letter code (GM, FR, US). Empty = all countries."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "count",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "articles": [
   {
    "url": "https://www.finanznachrichten.de/nachrichten-2026-08/69341019-coinshares-plc-coinshares-renames-wgmi-as-bitcoin-mining-and-digital-power-etf-reflecting-the-convergence-of-bitcoin-mining-and-ai-infrastructure-399.htm",
    "title": "CoinShares PLC : CoinShares Renames WGMI as CoinShares Bitcoin Mining and Digital Power ETF , Reflecting the Convergence of Bitcoin Mining and AI Infrastructure",
    "domain": "finanznachrichten.de",
    "language": "English",
    "seendate": "2026-08-18T11:30:00Z",
    "sourcecountry": "Germany"
   },
   {
    "url": "https://www.freepressjournal.in/business/bitcoin-etfs-see-390-million-weekly-outflows-as-investor-sentiment-turns-cautious",
    "title": "Bitcoin ETFs See $390 Million Weekly Outflows As Investor Sentiment Turns Cautious",
    "domain": "freepressjournal.in",
    "language": "English",
    "seendate": "2026-08-17T13:00:00Z",
    "sourcecountry": "India"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-news-headlines-search-via-gdelt-1cc034c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 4yearcycle.com](https://www.zero.xyz/host/4yearcycle.com/llms.txt)