# AgentUtility Crypto News with Sentiment

> AgentUtility Crypto News with Sentiment 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).

Fetches recent cryptocurrency news articles from GDELT 2.1 with per-article and aggregate sentiment analysis

## Facts

- Endpoint: POST https://x402.agentutility.ai/crypto-news
- 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-news-with-sentiment-e8c013ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-sDXwOCNEaIUq5YWlawrp

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-news-with-sentiment-e8c013ca -d '<json body>'
```

Example prompt: Pull the latest crypto news articles and tell me how they're trending sentiment-wise — are they mostly positive, negative, or neutral overall?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call snapshot of recent crypto news headlines paired with sentiment scores — especially useful for agents that need to gauge market mood or narrative direction without subscribing to a dedicated news API. Prefer over general search APIs when crypto-specific sentiment distribution is required in a single call.

## Known failure modes

- Payment not included or invalid x402 USDC payment → 402 Payment Required
- GDELT API unavailable or rate-limited upstream → 503 or timeout
- No articles found for topic in recent GDELT index → empty articles array
- Malformed request body → 400 Bad Request

## How this service works

Fetches recent cryptocurrency news headlines from GDELT with a GNews fallback when configured, filtered by crypto topic or caller query, returning headline URLs, domains, timestamps, language/country metadata, and headline sentiment. Not trading advice. Use it as a crypto news API or market news feed for bitcoin news, ethereum news, DeFi news, or stablecoin news.

## Output

A JSON object containing the topic queried, the source (GDELT 2.1 Document API), an array of articles (each with title, domain, and sentiment label and score), the count of articles returned, and an aggregate sentiment distribution (neutral/negative/positive counts) along with an average sentiment score across all articles.

## 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": {
     "properties": {
      "topic": {
       "type": "string",
       "enum": [
        "crypto",
        "markets",
        "defi",
        "bitcoin",
        "ethereum",
        "stablecoins"
       ],
       "description": "Preset topic. Default crypto."
      },
      "query": {
       "type": "string",
       "description": "Optional news query override, max 240 chars."
      },
      "limit": {
       "type": "number",
       "description": "Headlines to return, 1-30. Default 10."
      },
      "hours": {
       "type": "number",
       "description": "Lookback window in hours, 1-168. Default 48."
      }
     }
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "topic": {
       "type": "string"
      },
      "returned": {
       "type": "integer"
      },
      "sentiment": {
       "type": "object",
       "properties": {
        "average_score": {
         "type": "number"
        },
        "distribution": {
         "type": "object",
         "properties": {
          "positive": {
           "type": "integer"
          },
          "neutral": {
           "type": "integer"
          },
          "negative": {
           "type": "integer"
          }
         }
        }
       }
      },
      "articles": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "title": {
          "type": "string"
         },
         "domain": {
          "type": "string"
         },
         "sentiment": {
          "type": "object",
          "properties": {
           "label": {
            "type": "string"
           },
           "score": {
            "type": "number"
           }
          }
         }
        }
       }
      },
      "source": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "topic": "crypto",
  "source": "GDELT 2.1 Document API",
  "articles": [
   {
    "title": "Bitcoin rally sets record",
    "domain": "example.com",
    "sentiment": {
     "label": "positive",
     "score": 0.667
    }
   }
  ],
  "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-news-with-sentiment-e8c013ca/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)