# x402-gateway Crypto News Headlines

> x402-gateway Crypto News Headlines is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Fetches the latest crypto and blockchain news headlines from the last 72 hours via GDELT, with tone, people, and organization metadata

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/crypto-news?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-crypto-news-headlines-f83e6cf9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rKCE9mumuRqivlVei5Gxl

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 x402-gateway-crypto-news-headlines-f83e6cf9 -d '<json body>'
```

Example prompt: Pull me the latest 20 crypto news headlines from the past 24 hours — focus on bitcoin — and show me each article's title, source, tone, and any key people or organizations mentioned.

## When to prefer this

Use this endpoint when you need structured, metadata-rich crypto news headlines (with tone, people, and organization extraction) from the past 72 hours sourced from the GDELT global news graph. Prefer this over a general web search when you need normalized JSON output with sentiment signals, or when you need to filter by a specific coin or token. Do not use for real-time prices, full article body text, social media content, or news older than 72 hours.

## Known failure modes

- No articles found for a very niche token within the time window
- Hours parameter out of range (must be 1-72)
- Limit parameter out of range (must be 1-50)
- Token string fails regex validation (must be 2-30 alphanumeric characters)
- Payment failure — USDC payment not processed, endpoint returns 402
- GDELT data ingestion lag causing some very recent articles to be missing

## How this service works

Use when you need crypto news or crypto market news headlines about a token or the market from recent articles. Do not use for prices, full article text, social media posts or news older than 72 hours. Returns JSON with the latest crypto news headlines from the last 72 hours (title, link, source, time, tone, people and organizations) about bitcoin, ethereum and blockchain news, from the GDELT news graph for 0.005 USDC per call. Typical response time 1500 ms (p95). Category: Search.

## Output

Returns a JSON object containing: the queried token (or null for all crypto), lookback hours, article count, and an array of articles each with title, URL, source domain, published timestamp, tone score, image URL, persons mentioned, and organizations mentioned. Also includes a suggested next call for chaining.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {
      "hours": {
       "type": "integer",
       "maximum": 72,
       "minimum": 1,
       "description": "How far back to search, in hours (1-72, default 24)"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Most articles to return (1-50, default 20), newest first"
      },
      "token": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{2,30}$",
       "description": "Narrow to one coin, chain or company, e.g. solana, xrp or coinbase (any crypto news when omitted)"
      }
     }
    },
    "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",
     "required": [
      "token",
      "hours",
      "count",
      "articles",
      "lastIngestAt",
      "attribution"
     ],
     "properties": {
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "description": "Suggested next p
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "hours": 24,
  "token": null,
  "articles": [
   {
    "url": "https://aninews.in/news/national/general-news/hyderabad-5-arrested-in-rs-25-lakh-robbery-in-crypto-deal20261017214202/",
    "tone": -6.78,
    "image": null,
    "title": "Hyderabad: 5 arrested in Rs 25 lakh robbery in crypto deal",
    "domain": "aninews.in",
    "persons": [
     "Bharatiya Nyaya Sanhita",
     "Syed Ajaz",
     "Mohammed Faisal",
     "Guglavath Vijesh Kumar",
     "Syed Zakariya Ahmed",
     "Sumair Khan",
     "Faraz Hussain"
    ],
    "publishedAt": "2026-10-17T16:45:00.000Z",
    "organizations": [
     "Nampally Police",
     "Himalayan Hotel At Bazarghat"
    ]
   },
   {
    "url": "https://decrypt.co/380281/morning-minute-okx-raises-at-25b-from-circle-ripple-and-stanchart&t=Morning%20Minute:%20OKX%20Raises%20at%20$25B%20From%20Circle,%20Ripple,%20and%20StanChart&fnp_t=1792254492.2c1aa61f211d4848",
    "tone": -0.72,
    "image": "https://cdn.decrypt.co/resize/1024/height/512/wp-content/uploads/2026/03/okx-decrypt-style-gID_7.jpg",
    "title": "Morning Minute: OKX Raises at $25B From Circle, Ripple, and StanChart",
    "domain": "decrypt.co",
    "persons": [
     "Tyler Warner",
     "Bitcoin Etfssaw"
    ],
    "publishedAt": "2026-10-17T16:45:00.000Z",
    "organizations": [
     "New York Stock Exchange",
     "York Stock Exchange",
     "Blackrock",
     "Qube Research",
     "Intercontinental Exchange"
    ]
   },
   {
    "url": "https://www.miragenews.com/chips-under-control-1762163/",
    "tone": -1.39,
    "image": "https://www.mpg.de/27016264/original-1791212021.jpg?t=ZXlKM2FXUjBhQ0k2T0RRNExDSm9aV2xuYUhRaU9qUTNOeXdpWm1sMElqb2lZM0p2Y0NJc0ltWnBiR1ZmWlhoMFpXNXphVzl1SWpvaWFuQm5JaXdpYjJKcVgybGtJam95TnpBeE5qSTJOSDA9LS1kMGQ3ZTM4ZTI3OTg5ZmJhYzdlMGJmM2U4YzIxY2FiNzI5ZmJlM2Fh",
    "title": "Chips Under Control?",
    "domain": "miragenews.com",
    "persons": [
     "Hoang Nguyen Hien Pham",
     "Edward Snowden",
     "Thomas Brandstetter",
     "Christof Paar",
     "Julian Speith"
    ],
    "publishedAt": "2026-10-17T16:30:00.000Z",
    "organizations": [
     "Cryptographic Engineering Group Of Peter Schwabe",
     "Technology Nist",
     "Google",
     "Huawei",
     "Max Planck Institute For Security",
     "Microsoft",
     "Us National Institute Of Standards",
     "United States"
    ]
   },
   {
    "url": "https://blog.joehuffman.org/2026/10/17/this-is-how-ai-gets-physical/",
    "tone": 1.04,
    "image
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-crypto-news-headlines-f83e6cf9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)
