X

X402stock · News Sentiment

by X402stock

GETBase

$0.02

per call · USD Coin on Base

Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock

Endpoint

GET https://x402stock.xyz/api/v1/news-sentiment

1

Calls / 30d

1

Unique payers / 30d

Aug 20

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://x402stock.xyz/api/v1/news-sentiment", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://x402stock.xyz/api/v1/news-sentiment?q=Nvidia&timespan=1w" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "as_of": "2026-06-06T02:40:00.000Z",
  "attribution": "Source: The GDELT Project (https://www.gdeltproject.org/)",
  "query": "Nvidia",
  "recent_articles": [
    {
      "domain": "techtimes.com",
      "language": "English",
      "seen": "2026-06-06T02:15:00Z",
      "source_country": "United States",
      "title": "NVIDIA Is Not the Only AI Chip Winner: Broadcom Forecasts $56 Billion",
      "url": "https://www.techtimes.com/articles/317846/20260605/nvidia-not-only-ai-chip-winner-broadcom.htm"
    }
  ],
  "sentiment": {
    "average_tone": 0.31,
    "label": "neutral",
    "latest_tone": 0.42,
    "scale": "GDELT average tone, roughly -10 (very negative) to +10 (very positive); 0 is neutral.",
    "trend": "improving"
  },
  "source": "x402stock",
  "timespan": "1w",
  "tone_timeline": [
    {
      "date": "2026-06-06T00:00:00Z",
      "tone": -0.198
    },
    {
      "date": "2026-06-06T01:00:00Z",
      "tone": 0.755
    },
    {
      "date": "2026-06-06T02:00:00Z",
      "tone": 0.42
    }
  ],
  "venue": "gdelt",
  "volume": {
    "points": 167,
    "total_articles": 2841
  },
  "volume_timeline": [
    {
      "articles": 21,
      "date": "2026-06-06T01:00:00Z",
      "total_monitored": 3104
    },
    {
      "articles": 17,
      "date": "2026-06-06T02:00:00Z",
      "total_monitored": 3179
    }
  ]
}

Payment details

Pay to0x3070fbb3803819fb5bdfe9286fdc6325a877fa85
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Social & Community and the homepage with a featured placement.

Get featured →

More from X402stock & similar services