# AgentUtility Crypto Headlines

> AgentUtility Crypto Headlines is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches and returns recent Bitcoin, Ethereum, and DeFi news headlines with URLs, domains, timestamps, language/country metadata, and sentiment scores via GDELT with GNews fallback.

## Facts

- Endpoint: POST https://x402.agentutility.ai/crypto-headlines
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-crypto-headlines-af4c7a10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UOZekoMvablZajMo_aBrx

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 agentutility-crypto-headlines-af4c7a10 -d '<json body>'
```

Example prompt: Fetch me the latest Bitcoin, Ethereum, and DeFi headlines right now — I want the article URLs, which sites they came from, when they were published, and whether the sentiment is bullish or bearish.

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call crypto news feed with sentiment metadata and source provenance, especially in autonomous agent pipelines that settle payments in USDC on Base. Prefer it over full RSS scrapers or expensive news APIs when you only need crypto-specific headlines (BTC, ETH, DeFi) and want structured metadata including language, country, and sentiment without building your own aggregation pipeline.

## Known failure modes

- GDELT API unavailable and GNews not configured — returns empty or error response
- No recent headlines found for the queried topic — empty results list
- Rate limiting or payment failure via x402 — 402 payment required error
- Malformed POST body — 400 bad request
- GNews API key missing when GDELT has no results — partial or no fallback results

## How this service works

Searches recent bitcoin, ethereum, and DeFi headlines via GDELT with a GNews fallback when configured, returning headline URLs, domains, timestamps, language/country metadata, and headline sentiment. Not trading advice. Use it as a crypto headlines API or low-cost cryptocurrency news feed.

## Output

Returns a list of recent crypto news headlines, each with: article URL, source domain, publication timestamp, detected language, country of origin, and a sentiment score for the headline. Results come from GDELT with a GNews fallback. Not trading advice.

## 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": {
     "properties": {
      "hours": {
       "type": "number",
       "description": "Lookback window in hours, 1-168. Default 48."
      },
      "limit": {
       "type": "number",
       "description": "Headlines to return, 1-30. Default 10."
      },
      "query": {
       "type": "string",
       "description": "Optional news query override, max 240 chars."
      },
      "topic": {
       "enum": [
        "crypto",
        "markets",
        "defi",
        "bitcoin",
        "ethereum",
        "stablecoins"
       ],
       "type": "string",
       "description": "Preset topic. Default crypto."
      }
     }
    },
    "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",
     "properties": {
      "topic": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "returned": {
       "type": "integer"
      },
      "sentiment": {
       "type": "object",
       "properties": {
        "distribution": {
         "type": "object",
         "properties": {
          "neutral": {
           "type": "integer"
          },
          "negative": {
           "type": "integer"
          },
          "positive": {
           "type": "integer"
          }
         }
        },
        "average_score": {
         "type": "number"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "topic": "crypto",
  "source": "GDELT 2.1 Document API",
  "returned": 10,
  "sentiment": {
   "distribution": {
    "neutral": 6,
    "negative": 1,
    "positive": 3
   },
   "average_score": 0.1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-crypto-headlines-af4c7a10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)